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Introduction 


This document describes Release 2.2 for the Sun Workstation. This is an 
upgrade release. You must be running either Release 2.0 or 2.1 in order to load 
this release. Release 2.2 incorporates Release 2.1 with general bug fixes for 
Release 2.0 and 2.1. The procedures for installing and testing Release 2.2 from a 
distribution tape are included in this document. 

Chapter 2 describes the contents of Release 2.1. This release was restricted to 
the Sun-2/160 Color Workstation with the new Graphics Processor and Grpahics 
Buffer options. If you are not using this type of workstation proceed to Chapter 
3-Installing the 2.2 Release. This chapter combines installation instructions for 
workstations now running Release 2.0 as well as those running 2.1. Chapter 4- 
Software Bug Fixes is new to Release 2.2. Chapter 5-Errata Pages and Chapter 
6-Insert Pages contain information pertinent to both Release 2.1 and Release 2.2. 
Chapter 7 contains Appendix H:SunWindows Examples for the Programmer’s 
R^erence Manual for SunWindcws. 


1.1. Supporting 
Documentation 


The following manuals are useful for the installation procedures for Release 2.2. 

[1] System Administration for the Sun-2 Workstation 
(Part Number 800-1150). 

[2] Commands R^erence Manual for the Sun Workstation 
(Part Number: 800-1172). 

[3] Installing UNIX on the Sun Workstation 
(Part Number: 800-1158). 


NOTE If you have the Sun-21160 Color SunStation with a Graphics Processor, you may 

want to refer to the two manuals listed below: 

[4] Hardware Installation Manual for the Sun-21160 Color SunStation and 
Sun-21130 SunStation 
(Part Number: 800-1144). 


[5] Sun-21160 Diagnostic Manual 
(Part Number: 800-1236). ; 
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2.1. New Hardware Products 

2.2. New Software Products 

23. Changes to Operating 
System Software 

Device Drivers 


New Graphics Processor and Graphics 
Buffer Options for the Sun-2/160 

This chapter describes the contents of the Release 2.1 which exclusively sup¬ 
ported the Sun-2/160 Color Workstation widi the new Graphics Processor and 
Graphics Buffer options. Since these options are VME bus compatible boards 
that require a color system, Release 2.1 was restricted to the Sun-2/160. IF YOU 
DO NOT HAVE Sun-2/160 Color Workstation with the new Graphics Processor 
and Graphics Buffer PROCEED TO CHAPTER 3. 

The procedures for installing and testing this special release are incorporated in 
Release 2.2. A Release 2.0 installation is required before a Release 2.2 upgrade. 

The Graphics Processor (GP) and Graphics Buffer (GB) boards ate options 
designed to enhance graphics performance for the Sun-2/160 Color Workstation. 
These ate Eurocatd format printed circuit boards that fit into VME slots of the 
Sun-2/160 card cage. 

There are no new software products. 

The operating system software changes are included in a device driver for the 
Graphics Processor, microcode that is downloaded into the Graphics Processor, 
and a configuration utility that binds frame buffers to a GP board. 

The lowest level command interface for the Graphics Processor is not included. 
The Graphics Processor can only be used tiirou^ the graphics library routines 
that have been expanded to communicate with the GP. 

The file gpone.o is a binary copy of the device driver for the Graphics Processor 
board. It is installed in the kernel configuration directory during the software 
installation procedure. 

The file cgtwo.o is a new binary copy of a device driver for the color firame 
buffer. It has additional ioctl ’s for communicating with the Graphics Processor. 
This device driver is upward compatible with previous versions. 

The file consfb.o is a new binary copy of the device driver for the console frame 
buffer. Some applications like suntools(l) use Idevifb as the default frame 
buffer. This new version allows redirection of the GP frame buffer driver to 
Idevifb . 
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Downloadable GP Microcode 

gpconfig Command 

2.4. Changes to Application 
Software 

Graphics Libraries 


SunWindow Tools 

NOTE 


The files letclgplcg2.1152.ucode and !etc!gplcgl.1024.ucode contain micro¬ 
code that is downloaded into the Graphics Processor board when the Sun-2/160 is 
booted. 

The gpconfig command binds specific frame buffers to the Graphics Processor 
board. Since an individual Graphics Processor board can drive up to four frame 
buffers, the GP driver must be given certain frame buffer specific information. 
Chapter 4 includes a manual page, gpconfig (8), that describes the gpconfig com¬ 
mand and its arguments. If die Graphics Processor is to be used regularly, the 
gpconfig command should be added to the file letcirc.local . 

The application software that changed is limited to the graphics libraries listed 
below. New versions of some of the utilities from Release 2.0 must be recom¬ 
piled to run with these new libraries. Release 2.2 will not contain any new utili¬ 
ties. 

Four libraries in lusrllib have been revised to use the Graphics Processor board. 
Any application programs that depend on these libraries should be relinked with 
the newer versions. 

SunCGI The Sun Microsystems implementation of the Computer Graphics 
Interface (CGI) standard reflects Sun Microsystems interpretation of 
the March 1984 working draft of CGI. The file libcgLa is a new 
version of this graphics library for use with the GP. See 
Programmer’s Reference Manual for SunCGI (Part Number: 800- 
1166). Section 4 has an errata page reflecting the new GP device 
that should be included in this manual. 

SunCore SunCore is an implementation of the ACM Core graphics standard 
with extensions. The file libcore.a is a new version of this graphics 
library for use with the GP. The file libcoresky.a is a version of this 
library for use with the GP and a SKY floating point board. See 
Programmer's Reference Manual for SunCore (Part Number: 800- 
1165). Section 4 has an errata page reflecting the new GP device 
that should be included in this manual. 

Pixrects Pixrects is a low-level graphics library for manipulating rectangles 
of pixels with RasterOps. The file libpixrect.a is a version of this 
graphics library for use with the GP. See Programmer’s R^erence 
Manual for SuriWindows — the Sun Window System (Part Number: 
800-1167) and Programmer’s Tutorial to SunWindows (Part 
Number: 800-1182). 

There are no new SunWindow tools widi this release. Tools from Release 2.0 
must be reinstalled with the new graphics libraries described above. This is per¬ 
formed automatically installation utility. 

Locally written tools must be relinked with the new graphics libraries. 
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2^. Performance Issues 


Pixrects 


SunCGI 


SunCore 


This release represent the first stage of an ongoing effort to improve graphics per¬ 
formance through the use of the GP. The Pixrects, SunCGI, and SunCore graph¬ 
ics libraries will all provide increased performance. The sections that follow out¬ 
line the graphics performance improvements resulting from the GP. 

Vector pixel rates have increased by about a factor of 5. Solid-filled rectangle 
rates have increased by more than a factor of 3. RasterOps from one area to 
another on the frame buffer (e.g. scrolling) have increased by more than a factor 
of 3. Polygon scan conversion is nearly 10 times faster for certain polygons Pix- 
rects caimot currently exploit the full performance of the GP due to the lack of a 
batching mechanism. 

Sun CGI takes advantage of the Pixrects level performance improvements and 
also used the GP to perform coordinate transformations from VDC to device 
coordinates. SunCGI also sends the vectors of a polyline to the GP as a batch of 
vectors which greatly improves polyline speed. 

Since SunCore has floating point world coordinates and a display list, several 
further performance improvements are achieved wifli the GP. Vectors can be 
read out of a retained segment in the display list, 3D images transformed, clipped 
and drawn at over 20,000 vectors per second. The transformatior^ from floating 
point world coordinates to NDC space are performed by the GP as well as vari¬ 
ous matrix multiply operations. These floating point operations are improved by 
as much as 200 times. 2D and 3D solid color or Gouraud shaded polygons are 
transformed, clipped, scaled, or rendered by the GP. If a GB board is present, 
hidden surface elimination for 3D solid or Gouraud shaded polygons is also per¬ 
formed by the GP. 
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Installing the 2.2 Release 


In this chapter, we give directions for installing the Sun 2.2 release software on a 
Sun system running the 2.0 Release. 

NOTE We recoinmend that you install the 2.2 Release in single user mode. If you do 

not, you will be unable to upgrade the following four programs: /etc/inetd., 
/etc/ypbind, /usr/etc/rpc.mountd, and /usr/lib/lpd. 

These are multi-user mode processes. You can not 
overwrite existing active processes. 

The directions below assume you are working with the incremental release 
software on either one 1/4” or 1/2” tape, and support installation on 

□ Standalone machines with local tape and disk, which can read in the distri¬ 
bution tape via the local tape drive; 

p Machines with a local disk, but no local tape drive, that are on a network. 
Such machines will use the tape drive on another machine (called 
remote host or server_name in the procedures) to read the tape; 

□ Server machines with local tape and disk and with diskless clients, which 
will use the local drive to install both the server and its clients. 

Before begirming installation, there are several important things you should be 
aware of: 

□ If you are already running release 2.0, you must have at least 508KBytes of 
disk space available on your root partition, and at least 26KBytes available 
on your /usr partition to do this installation. If you wish to load the optional 
software included on the tape (manual pages and demonstration executables 
and source), allow at least another 4.0 MBytes on lusr (22 KBytes for the 
manual pages, 3.5 MBytes for the demos and 485 Kbytes for the games). 

The dfiX) command displays information about space available in each file 
system. You should use this command before installing the 2.2 Release 
software to make sure that there is enough disk space available for it. For 
example: 


#sun 13 Revision: A of 3 October, 1985 
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gaia% df 


Filesystem 

kbytes 

used 

avail 

capacity 

Mounted on 

/dev/xyOa 

7437 

5470 

1223 

82% 

/ 

/dev/xyOh 

148455 

128709 

4900 

96% 

/usr 

/dev/xyOg 

117327 

66896 

38698 

63% 

/usr/misc 


iandsoon\ 

In this example, the lusr file system has 4,9 MBytes of disk space available. 

□ If you are installing a new disk, you must follow the directions in "Installing 
Unix on the Sun Workstation" (Part Number: 800-1158) for formatting and 
labeling it. 

□ This upgrade release is for installation only on systems running Release 2.0 
or 2.1 software. This release is incremental in the sense that you need not 
re-install the complete operating system. 

□ This release is intended for installation as a package; you must install the 
entire release. Sun will not provide direct support for users who wish to 
install selected portions of the release software. 

o You can ‘un-install’ this release if you have to; a facility has been provided 
with the release for backing out changes. In most circumstances, you should 
not find this necessary; however, if you do, please inform Sun Microsystems 
Technical Support — we’d like to know what went wrong. 

□ You must build and install a new operating system kernel to complete the 
installation of the 2.2 release, 

□ We strongly advise a thorough back-up before beginning installation. See 
the manual entry dump (8) in the Commands Rrference Manual for the Sun 
Workstation (Part Number: 800-1166). 

□ In order for the GP and/or the GB to run, the command letclgpconfig must 
be run when the workstation is booted. This command loads the GP and GB 
boards with their respective microcode. This can be done automatically if 
the file letcirc.local is edited to include the gpconfig command line. See the 
manual page for gpconfig (8) in Chapter 6 of this document. 

3.1. What is on the Distribution of the 2.2 Release binaries is either on a 1/4” magnetic tape car- 

Distribution Tape? tridge or a 1/2” nine-track tape. The tapes contain eight files, as follows: 

Boot block. 

A general-purpose boot program which knows how to boot from the 
various devices that can be attached to the Sun Workstation. The 
PROM monitor boots this general-purpose boot program. 

Bootable diag program. 

diag is the disk formatting and labeling program. 

Copyright file. 
tar file of the backup utility. 

This tar file contains two files: the backup utility {2.2_backiqj) which 
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File 1: 

File 2: 

File 3: 
File 4: 
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saves the current versions of the files replaced in this upgrade and the 
listing of files which changed between 2.2 and 2.0 {get_archy). 

File 5: tar file of the 2.2 upgrade utility {2.2_upgrade). 

File 6: tar file of new 2.2 object 

A tar format file of the 2.2 object files, executable files, and libraries. 

File 7: tar file of optional software. 

With Release 2.2, this includes several new/revised manual pages, gp 
demos, and gp diagnostics. 

File 8: Copyright file. 

3.2. Overview of the The object of this procedure is to load the Release 2.2 binaries firom the magnetic 

Installation Procedure tape onto your local or network disk subsystem. You will need to have a blank 

tape for Step 5. 

The basic steps in installation are: 

1. Boot single user mode. 

2. Load the release tape. 

3. Extract the 2.2 backup utility and 2.2 upgrade utility. 

4. If you are installing a server, halt any diskless clients. 

5. Run the 2.2 backup utility. 

6. Run the 2.2 upgrade utility. 

7. Optionally, use the far(l) command to extract the manual pages and/or color 
demos. 

8. If you have a Sun-2/160 with a Graphics Processor, edit the file /etdrc.local 
to contain a command line for letcigpconfig (8). 

9. Reconfigure your system kernel and reboot. 

If you have performed an installation of a Sun system before, you will recall that 
we use several conventions in the procedures and examples to try and clarify 
things: 

□ What the system types at you is printed in typewriter font like 
this. 

□ What you type at the system is shown in boldface typewriter 
font like this. Everything shown in boldface should be typed 
exactly as it appears. 

a Where parts of a command are shown in italic text like this, they refer to a 
variable which you have to substitute from a selection; it is up to you to 
make the proper substitution. 

The rfijpe variable is important. The values for tape are listed in Table 3-1. 
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For example, a common configuration would load from a quarter-inch magnetic 
tape cartridge via an SCSI tape controller. In this case, tape would be replaced 
by St (SCSI Tape) everywhere. 

Now, you are ready to begin the actual installation. 

3.3. Boot single user mode To boot single user mode, do the following; 

gaia#/etc/shut down -h 
>b vznunix -s 
# /etc/mount /usr 

3.4. Load the Release Tape 

NOTE If you are installing 2,2 on a network disk server, you must have a tape drive on 

the server machine. 

NOTE We do not guarantee full compatibility between the 4-track 20 MByte and the 9- 

track 45 MByte drives. 

Your chances of successfully reading tapes produced by a different type of drive 
are increased if you follow the manufacturer’s instructions for drive mainte¬ 
nance: clean the drive heads after every use of a new tape and after every eight 
hours of use. 

Load the release tape. 


3.5. Extract the 2.2 Backup 
and Upgrade Utilities 
firom Tape 


When you have loaded the tape, use the tar{\) cormnand to extract the 
2.2_upgrade , the 2.2 installation utility. 

□ If you are using a local tape drive, do the following. Remember to replace 
tape with the appropriate device abbreviation for your tape {ar for the 
Archive drive, for an SCSI tape drive, or mt for die nine-track tape): 

# cd /usr/etc 

# mfc -f /dBv/iixtapeO ret 

[Note: a 1/2“ tape drive cannot be retensioned] 

# mt -f /dev/nrwpeO rew 

# mt -f /dev/nrrapeO faf 3 

# tar xvp£ /dev/nrWpeO 

X 2.2_backup 3488 Bytes, 7 tape blocks 
X get_arch_f 3924 Bytes, 8 tape blocks 

# mt -f /dev/nrra/»c 0 rew 

# mt —£ /dev/nrra/»0 £s£ 4 

# tar xvp£ /dev/nrra/^eO 

X 2.2_upgrade 4494 Bytes, 9 tape blocks 

# 

The ret option of the mt(l) command will cause the tape drive to wind the 
tape forward to the end and back to the beginning to get even tension on the 
tape. 



Revision: A of 3 October, 1985 






Installing the 2.2 Release 17 




o If you are using a remote tape drive, do the following. Note that, since you 

ate performing a remote process as super-user, the hostname of the local 
m ac hine (which you are typing commands on) must be in the remote 
machine’s Lrhosts file to avoid permission problems. In addition, each 
machine must have an entry for the other (name and Internet address) in its 
letcihosts file. Remember to replace tape with the appropriate device abbre¬ 
viation for the remote tape drive you are using, to replace remotejiost with 
the hosmame of the machine this tape drive is attached to, and to replace 
block_size with 206 fora 1/2” tape or 126b for a 1/4” tape: 

# cd /usr/etc 

# rsh remotejiost mt -f /dev/nrtapeO ret 

[Note: a 1/2" tape drive cannot be retensioned] 

# rsh remotejiost mt —£ /dev/nrtapeO rew 

# rsh remotejiost mt -f /dev/nrtopcO fsf 3 

# rsh remotejiost dd if=/dev/nrrupeO \ 

i>3=block_size \ tar xvpBf - 

X 2.2_baclcup 3488 Bytes, 7 tape blocks 

X get_arch_f 3924 Bytes, 8 tape blocks 

# rsh remotejiost mt -f /dev/nrtep«0 rew 

# rsh remotejiost mt -f /dev/nrfap«0 fsf 4 

# rsh remotejiost dd i£=/dev/nrraptf 0 \ 

bB=block_size \ tar x:vpB£ - 

X 2.2_upgrade. 4494 Bytes, 9 tape blocks 

# 

If you get a “Broken pipe” message, you can ignore it. 


3.6. Halt Diskless Clients If you are installing a server, halt all diskless clients. 


3.7. Run the 2.2 Backup 
Utility 


o 


Next, you run the 2.2 backup utility to save the 2.0 or 2.1 files on your disk that 
are replaced in this upgrade. This process takes about 20 minutes. 

You will now need a blank tape. 

The backup utility will not support backup for ND clients. If you have changed 
any of the following files in the clients’ root file systems, you will manually have 
to dump each client. The files affected are; 

/etc/gplcg2.1024.ucode 

/etc/gplcgll 152.ucode 

/etc/gpconfig 

/etc/inetd 

/etc/mount 

/etc/nfsd 

/etc/mount 

'/etc/shutdown -h 

/etc/umount 

/etc/ypbind 

/etc/ypserv 

/etc/yp/makedbm 
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/dev/MAKEDEV 


You can tar these files to blank tape. Whenever you need to nninstijll a client, 
backup your server first then tar these files back to flie client. 

If you are not running 2.1 release, when you do 2.2 backup you will see the fol¬ 
lowing message: tar: filename: no such file or directory 
for any files that pertain to the 2.1 release. The files affected are: 

/etc/gplcg2.1024.ucode 
/etc/gplcg2.1152.ucode 
/etc/gpconfig 

/usr/sys/OBJ/gpl_colonnap.o 

/usr/sys/OBJ/gpl_kem_sync.o 

/usr/sys/OBJ/gpl_rop.o 

/usr/sys/OBJ/gpone.h 

/usr/sys/OBJ/gpone.o 

/usr/sys/conf/SDSTl 60GP 

/usr/sys/sun/gpio.h 

/usr/include/sun/gpio.h 

/usr/include/gpl_pwpr.h 


If you are not using the yellow pages and have moved ypbind to ypbind- you will 
want to reverse this with the following command before you proceed: 

mv /etc/ypbind- /etc/ypbind 

There are two parameters with the 2.2_backup utility, (the command is printed 
on two lines for formatting purposes only; type it as a single line): 

# /usr/ehc/2.2_baclcup {a r 1 mt 1 st} 

{server | tapefull | tapeless serverjiame } 

The backup command and system response for a server machine will look like 
this: 


# f(LB/usr/etc/2.2_backup mt server 
Beginning backup 

backup: load blank tape to mt and press return. 
Extracting object files for backup. 

NOTE Make sure your tape is write protected after finishing this step. 

3.8. Run the 2.2 Upgrade Load the release tape now. 

Utility 


NOTE Do not run SunWindows during the upgrade procedure. 

If you are doing the upgrade on a server, note that the upgrade utility takes cate 
of 2.2 upgrade on your diskless clients, but that it assumes a standard form of the 
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nd configuration file /etc/ndJocal in order to do so. In particular, if there are 
lines in the server’s letc/nd.local for client partitions which are commented out 
(lines with a leading *#’), these clients will not have 2.2 installed on them. If you 
wish to have the 2.2 Release installed on these clients, you must remove the com¬ 
ment symbol from their lines in the file before performing installation on the 
server. If you do not do this during the initial install, you will have to run 
through the entire installation procedure again (on the server and all die clients) 
in order to bring the conunented-out client partitions up to date. 

Also, if your/erc/nii./<?cal file has user... lines and/or ether ...lines 
that refer to non-existent clients, comment out these lines before running the 
installation utility. Again, the utility will not run to completion if this is not 
done. 

There are two parameters with the 2.2_upgrade utility, (the command is printed 
on two lines for formatting purposes only; type it as a single line): 

# /usr/etc/2.2_upgrade {arlmtlst} 

{server | tapefull [ tapeless server name } 

□ The first set specifies yotu" tape device: 

Table 3-1 Tape Devices 


Devices 


or 

Archive quarter-inch tape 

mt 

Nine-track magnetic tape 

St 

SCSI tape controller 


□ The last designates your machine as a server, standalone with tape drive, or 
workstation without a tape drive using a another machine’s (server_name) 
tape drive: 

server 

tapefull 

tapeless serverjiame 

For example, the installation command and system response for a server machine 
with a half-inch tape drive would look like this: 
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# /usr/etc/2.2__upgrade mt server 

Beginning 2.2 install. 

Extracting 2.2 object files. 

[ and soon... extraction takes about 20 minutes ... ] 


Installing new bootable code on server. 
Beginning 2.2 install on diskless clients. 
Beginning 2.2 install on client client_l. 
Completed 2.2 install on client clientj. 
Beginning 2.2 install on client client_2. 
Completed 2.2 install on client client^. 
Beginning 2.2 install on client client^. 
Completed 2.2 install on client cHent_3. 
Completed 2.2 install on diskless clients. 
Running ranlib on new libraries. 


2.2 install completed. 

You should now reconfigure and rebuild your kernel. 

NOTE If you are using an SCSI tape for the install, you may get a message like 

'Vdev/nrstO rewind 1 failed: I/O or” at the beginning or 
end of the install utility. You can ignore it. 

To install the release on a tapeless workstation using the 1/4’ ’ SCSI tape drive on 
a machine named hal, the command line would be; 

# /usr/etc/2.2_upgrade st tapeless hal 


3.9. Loading Optional 
Software from the 
Release Tape 


The seventh file on the upgrade tape contains new/revised manual pages, several 
new color demos and games, and GP diagnostics. You may optionally load diis 
software. 

Manual pages take approximately 22 KBytes of space. They are: 

gpone{AS) 
gpconfig{%) 
nfsmount(2) 
mount (8) 
toolplaces (1) 

Jt(4S) 
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Demos take approximately 3.5 MBytes of space. They are: 

cframedemo 

framedemo 

jumpdemo 

rotobj 

shaded 

showmap 

stringart 

DATA/*.vecs 

READ_ME 

show 

flight 

draw 

suncube 

molecule 

Games take approximately 485 KBytes of space. They are: 

gammontool 

chesstool 

The GP diagnostic program is the file gpl.2.diag. It takes 400 KBytes. 

To extract the optional software use tte directions that follow. 

o First forward position the tape with mf(l) to file 7. 

# cd /usr 

# mt -f /dev/nrra/»e 0 rew 

# mt -f /dev/nrfapeO £s£ 6 

□ Use the appropriate command line arguments to tar to select which direc¬ 
tories {demo, man, and/or games) you wish load. If you do not specify a 
directory, tar loads the manual pages, demos and games. The complete load 
takes about 14 minutes, regardless of which options are chosen. 

For a machine with a local tape drive: 

# tar atvp£ /dev/nrtapeO ./man 

loads manual pages 

# tar *vpf /dev/nr/apeO ./demo 

loads demonstration programs 

# tar xvpf /dev/nrWpe0 ./games 

loads games 

# tar 3 cvp£ /dev/nrrapeO ./games ./demos 

loads games and demos 

# tar xvpf /dev/nrrapeO 

loads manual pages, demonstration programs, and games 

# tar xvpf /desr/tixtapeO /stand 

loads GP diagnostic 

# mt -f /dev/nrrapeO rew 
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For a machine using a remote tape drive, type the following. Remember to 
replace tape with the appropriate device abbreviation for the remote tape 
drive you are using, to replace remotejiost with the hostname of the 
machine this tape drive is attached to, and to replace blockjsize with 20b for 
a 1/2” tape or 126b for a 1/4” tape: 

# cd /usr 

# rah remotejiost mt -£ /dev/nrW/jfi 0 rew 

# rah remotejiost mt -f /dBv/nrtapeO fsf 6 

# rah remotejiost dd if=/dev/nrte/7«0 \ 

ha=‘block_size | tar xvpBf - ./man 

# rah remotejiost mt *-f /dev/nrtape 0 rew 

See the above discussion of loading with a local tape drive for an explana¬ 
tion of how to optionally load the manual pages, demonstration programs 
and/or games with tar. 

The dd command above will print the number of records read in and written out, 
for example: 

6+0 records in 
6+0 records out 

This message may be interspersed with the standard error output from tar and, in 
any case, may be ignored. Also,-you can ignore the “Broken pipe” message 
delivered by tar. 

a If you load the pages, and normally use catman(8) to create pre-formatted 
copies of your online manual pages, then don’t forget to re-issue the catman 
command for the new 2.2 pages. 


3.10. Reconfigure your UNIX 
System Kernel 

NOTE Changes have been made to the device description lines in the kernel 
configuration file to allow for the Sun-21160 GP option. 

Finally, to complete the 2.2 Release installation, you must reconfigure your sys¬ 
tem kernel. 

NOTE Changes have been made to the device description lines in the kernel 
configuration file to allow for the Sun-21160 GP option. 

If you are doing kernel configuration for the first time, you can use the pro¬ 
cedures in 

Installing UNIX on the Sun Workstation 
(Part Number: 800-1158). 

If you have previously configured a kernel, you can use the following sections to 
guide you through reconfiguration. The first subsection is an annotated copy of 
the new GENERIC kernel configuration file; read it carefully to make sure you 
are including the correct device description lines for your system. The second 
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subsection gives reconfiguration procedures for standalone machines, and the 
third subsection addresses servers. 


Kernel Reconfiguration for 
Standalone Systems 


For standalone machines, proceed as follows. 

1. Change the current directory to Isyslconf: 

# cd /sya/conf 

2. Create a kernel configuration file. There are two ways to produce the kernel 
configuration file. 

□ Copy the file GENERIC and comment out the lines that don’t apply to your 
system. We’ll call the new file SYS_NAME (the name of the system). For 
example, 

# cp GENERIC SYS_NAME 

# Chxnod +w S¥S_NAME 

n Alternatively, copy the file SDST160GP onto a file called 5ys_Afi4M£ (the 
name of die system). This file is a basic Model 160 kernel configuration file. 
If you have any additional devices on your system, you shoidd add lines to 
this file as appropriate for your system. 

# cp SDST160GP SYS_NAME 

# chmod +w srs_NAME 

3. Edit lsyslconflSYS_NAME to reflect your system configuration. Use the anno¬ 
tated copy of GENERIC provided in the following section for an explanation 
of these changes. Make sure you are including the proper device description 
lines for your system. 

4. Edit the file letdrc.local to contain a line for the gpconfig (8) command. 

/etc/gpconfig gponeO -b -f cgtwoO 
for initializing the GP and GB 


/etc/gpconfig gponeO -f cgtwoO 
for initializing the GP only 

If you don’t want to have the GP and/or GB boards active all the time, you can 

ran the gpconfig (8) command interactively. 

5. Create the directory ../SYSJIAME (if you haven’t already) to contain the ker¬ 
nel image. Remember; since the system build utility letciconfig places its 
output files there, this directory must have the same name as your system 
configuration file: 

# mkdir .. /SYSJTAME 

6. Still in the /^j/con/directory, ran letciconfig. Then change directory to the 
new configuration directory, and make the new system (remember to substi¬ 
tute your actual system image name for SYSJIAME)’, 
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# /etc/config SYS_NAME 

# ed . . /SYS_NAME 

# make depend 

[ lots of output ] 

# make 

[ lots of output ] 

7. Now you can save your old kernel and install your new one: 

# mv /vmunix /vmunix.old 

# cp vxminlx /vnnmix 

# /etc/shutdown -h 

r/w system goes through the halt sequence, then 
the monitor displays its prompt, at which point you 
can boot the system: 

> b 

The system boots up multi-user, and then 
you can try things out. 
gala# 


8. If the system appears to work, this completes the upgrade procedure. If per¬ 
formance is slow, check that gpconfig has been run properly. If the new ker¬ 
nel doesn’t seem to be functioning properly, boot Ivmunix.old , copy it back 
to Ivmunix , and go about fixing your new kernel: 


# /etc/shutdown -h 
> b vmunix.old ~s 

# mv /vmunix /vmunix.oops 

# cp /vmunix.old /vmunix 

# “D t Brings the system up multi-user ] 
gala# 


Kernel Reconfiguration for 
Servers 


For server machines, proceed as follows. 

1. Change the current directory to Isys/conf: 

# cd /sys/conf 

2. Create a kernel configuration file. There are two ways to produce the kernel 
configuration file. 

□ Copy the file GENERIC and comment out the lines that don’t apply to your 
system. We’ll call the new file (the name of the system). For 

example, 

# cp GENERIC SYSJtAME 

# chmod +w SYS NAME 


Alternatively, copy the file SDST160GP onto a fiOie called SYSJ/AME (the 
name of the system). This file is a basic Model 160 kernel configuration file. 
If you have any additional devices on your system, you should add lines to 
this file as appropriate for your system. 
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# cp SDST160GP SYS_NAME 

# chmod +w SYS_NAME 

3. Editto reflect your system configuration. Use the anno¬ 
tated copy of GENERIC provided in the previous section for an explanation 
of these changes. Make sure you are including the proper device description 
lines for your system. 

4. Edit the file letcirc.local to contain a line for the gpconfig (8) command. 

/etc/gpconfig gponeO -b -f cgtwoO 
for initializing the GP and GB 



/etc/gpconfig gponeO -f cgtwoO 
for initializing the GP only 

If you don’t want to have the GP and/or GB boards active all the time, you can 

run the gpconfig 8 command interactively. 

5. Create the directory JSYSJfAME (if you haven't already) to contain the ker¬ 
nel image. Remember: since the system build utility letciconfig places its 
output files there, this directory must have the same name as your system 
configuration file: 

# mkdir ../SYSJIAME 

6. Still in the Isysiconf directoiy, run letciconfig. Then change directory to the 
new configuration directory, and make the new system (remember to substi¬ 
tute your actual system image name fox SYSJIAME)'. 

# /etc/config SYSJIAME 

# Cd. . . /SYSJAME 

# make depend 

[ lots of output ] 

# make 

[ lots cf output ] 

7. If you have a specially configured client kernel, it can be reconfigured now 
as well: 
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# cd /sys/conf 

# cp GENERIC CUEm_KERNELJiAME 

# Chmod +W CUENTJCERNELJIAME 

[ Edit CUENTJCERNELJIAME to reflect all clients’ systems. 

Be especially careful with the device description lines, given above. 

# nkdir . . /CUENTJCERNEL NAME 

# /etc/config CUENTJCERNELJIAME 

# cd . . /CUENTJCmiNELJIAME 

# make depend 

[ lots of output ] 

# xnake 

[ lots of output ] 



8. Now you can position yourself in the directory which has the server’s kernel 
in it, save your server’s old kernel, install your new one, and try everything 
out: 


# 

# 

# 

# 


> 


cd . . /SYSJIAME 
mv /vstunlac /vmunix.old 
cp vmunlx /vmunix 
/etc/shutdoMi -h 

The system goes through the halt sequence, then 
the monitor displays its prompt, at which point you 
can boot the system: 

b 


The system boots up multi-user, and 
then you can try things out. 
gaia# 


9. Next, install the appropriate client kernel in Ipub. 

□ If you reconfigured a special client kernel (in Step 5 above), copy it into 
Ipub: 

# cd /ay9/CUENT_KERNELJIAME 

[or wherever your client kernel /s) 

# cp vmunix /pub/vmunlx 


□ Otherwise place a copy of your server’s kernel (if appropriate) in Ipub: 
# cp /vmunix /pub/vmunlx 


9. If everything appears to work, you can finish by rebooting each of your 
clients. See the final step in the standalone instructions above if you have 
problems with your kernel. 

NOTE If you want to run the yellow pages, be sure to move ypbind- back to 

ypbind. 

If performance is slow, check that gpconfig has been run properly. 

o 
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Kernel Reconfiguration — an The following pages provide an annotated copy of the GENERIC file shipped 
Annotated Copy of GENERIC with this distribution. You can use the explanations of each line in the file to 

determine which lines should be included in your own system configuration file. 


# 

# GENERIC SUN 

# 

machine sun 

[mandatory.] 

cpu "SON2" 

[mandatory.] 

ident GENERIC 

[mandatory. If you use GENERIC as your system identifier, you may use die swap generic clause in the 
conf ig line below. If you customize the identifier to SYS_NAME, you must either include an options 
GENERIC line, or specify at least the device where your root file system lives in place of swap generic. For 
example, the conf ig line for a standard Sun-2 mi^t read: conf ig vmunix root on xy. Se& General 
and Specific System Description Lines , in Installing Unix on the SunWorkstation above, for information. 

Finally, if SYS_NAME contains both alpha and numeric characters (as in, for example, SDST120), you must 
enclose the name in double quotes ("SDST120") or you will get a syntax error when you run letciconfig .] 

timezone 8 dst 

[mandatory. Specifies your tiraezone. Adjust value accordingly.] 
maxusers 4 

[mandatory. Number may vary. For most systems, “2” is the proper value for maxusers. 

options IHET 

[mandatory. Controls inclusion of Internet code. Seei/ier(4). You must also include the pseudo—device 
inet and pseudo-device loop lines below.] 

options SYSACCT 

[Controls inclusion of code to do process accounting. See acct(2) and accf (5). If you include this line, you must 
also include the pseudo-device sysacct line below.] 

options RRC 

[Necessary for the network file system.] 
options NFS 

[Necessary for the network file system.] 
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config vmunix swap generic 

[mandatory. Specify kernel name and configuration clauses. See Specific System Description Lines, above, for 
information.] 

pseudo-device rpc 

[Necessary for the network file system.] 

pseudo-device nfs 

[Necessary for the network file system.] 

pseudo-device pty 

[Pseudo-tty’s. Needed for network or window system.] 

pseudo-device bk 

[Berknet line discipline for high speed tty input. See bk{4).] 

pseudo-device sysacct 

[See options SYSACCT line above.] 

pseudo-device inet 

[mandatory. See options INET line above.] 

pseudo-device ether 

mandatory. 

[ARP code. Seearp(4).] 

pseudo-device loop 

[mandatory. Software loop back network device driver. See lo (4). Must include with ‘options INET’.] 
pseudo-device nd 

[Network disk. Necessary for servers and diskless clients, and for machines serving as remote hosts for remote 
installation. Seeni/(4).] 

pseudo-device winl28 

[Window system. Number indicates maximum windows. If you include this line, you must also include the 
pseudo-device dt op, ms, and kb lines just below.] 


pseudo-device dtop4 
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[Maximum number of screens (desktops). Required for window system.] 


pseudo—device ms3 

[Maximum number of mice. Required for window system. See ms (4).] 


pseudo-device kb3 

[Maximum number of Sim keyboards. Required if using any Sun keyboard, and for the window system.] 

pseudo-device ingres 

[Sim MicroINGRES lock device.] 


controller mbO at nexus ? 

[mandatory. Main bus code.] 


controller ipcO at mbO csr all virt 0xeb0040 priority 2 

[1st Interphase SMD disk controller. See ip (4).] 



controller ipcl at mbO csr all virt 0xeb0044 priority 2 

[2nd Interphase controller.] 


disk ipO at ipcO drive 0 

[1st disk on 1st Interphase controller.] 


disk ipl at ipcO drive 1 

[2nd disk on 1st Interphase controller.] 


disk ip2 at ipcl drive 0 

[1st disk on 2nd Interphase controller.] 

disk ip3 at ipcl drive 1 

[2nd disk on 2nd Interphase controller.] 


controller xycO at mbO csr all virt 0xebee40 priority 2 vector xyintr 72 
[ 1 St Xylogics SMD disk controller. See xyi4).] 



controller xycl at mbO csr all virt 0xebee48 priority 2 vector xyintr 73 

[2nd Xylogics controller,] 
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disk xyO at xycO drive 0 

[1st disk on 1st Xylogics controller.] 

disk xyl at xycO drive 1 

[2nd disk on 1st Xylogics controller.] 

disk xy2 at xycl drive 0 

[1st disk on 2nd Xylogics controller.] 

disk xy3 at xycl drive 1 

[2nd disk on 2nd Xylogics controller.] 

controller scO at tnbO csr 0x80000 priority 2 

[1st SCSI controller on a Sun-2/120 or Sun-2/170.] 

controller scO at mbO csr vme busmem 0x200000 priority 2 vector scintr 64 

[1st SCSI controller on a Sun-2/160.] 

disk sdO at scO drive 0 flags 0 

[1st disk on 1st SCSI controller.] 

disk sdl at scO drive 1 flags 0 

[2nd disk on 1st SCSI controller.] 

tape stO at scO drive 32 flags 1 

[1st SCSI tape.] 

controller scl at mbO csr 0x84000 priority 2 

[2nd SCSI controller.] 

disk sd2 at scl drive 0 flags 0 

[1st disk on 2nd SCSI controller.] 

disk sd3 at scl drive 1 flags 0 

[2nd disk on 2nd SCSI controller.] 

tape stl at scl drive 32 flags 1 
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[2nd SCSI tape.] 

device ropcO at mbO csr OxeeOSOO 

[mandatory. RasterOp chip. See rope (4).] 

device skyO at mbO csr 0x2000 priority 2 

[Sky Floating Point board in any Sun-1, Sun-2/120, or Sun-2/170.] 

device skyO at mbO csr vme busio 0x8000 priority 2 vector skyintr 176 

[Sky Floating Point board in a Sun-2/50 or Sun-2/160.] 

device zsO at mbO csr all virt OxeecSOO flags 3 priority 3 # epu 

[CPU serial I/O ports. See zs (4),] 

device zsl at mbO csr all virt OxeecOOO flags 0x103 priority 3 # video 

[Sun-2 Video Board ports. Required for Sun-2 keyboard and mouse.] 

device zs2 at mbO csr 0x80800 flags 3 priority 3 

[1st two serial I/O ports on 1st SCSI Board.] 

device zs3 at mbO csr 0x81000 flags 3 priority 3 

[2nd two serial I/O ports on 1st SCSI Board.] 

device Z34 at mbO csr 0x84800 flags 3 priority 3 

[1st two serial I/O ports on 2nd SCSI Board.] 

device zs5 at itibO csr 0x85000 flags 3 priority 3 

[2nd two serial I/O ports on 2nd SCSI Board.] 

device mtiO at tnbO csr all virt 0xeb0620 flags Oxffff priority 4 vector nttimtr 136 

[Systech terminal MUX. See mti (4).] 

device ieO at mbO csr 0x88000 priority 3 

[1st Sun-2 Ethernet Controller on a Sun-2/120 or Sun-2/170.] 

device ieO at mbO csr vme virt 0x0ee3000 priority 3 

[1st Sun-2 Ethernet Controller on a Sun-2/50 or Sun-2/160.] 
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device iel at iribO csr 0x8c000 flags 2 priority 3 

[2nd Sun-2 Ethernet Controller on a Sun-2/120 or Sun-2/170.] 



device ecO at n\bO csr OxeOOOO priority 3 

[1st 3COM Ethernet Controller. See ec (4).] 

device iel at mbO csr vme busmem 0xe88000 priority 3 
device eel at mbO csr 0xe2000 priority 3 

[2nd 3COM Ethernet Controller. See ec (4).] 


controller tmO at mbO csr all virt OxebOOaO priority 3 vector tmintr 96 

[1st TAPEMASTER tape controller. See /ot(4).] 


controller tml at mbO csr all virt 0xeb00a2 priority 3 vector tmintr 97 

[2nd TAPEMASTER tape controller. See tm (4).] 


tape mtO at tmO drive 0 flags 1 

[1st 1/2” tape drive on 1st TAPEMASTER controller.] 


tape mtl at tml drive 0 flags 1 

[1st 1/2” tape drive on 2nd TAPEMASTER controller.] 



controller xteO at mbO csr all virt 0xebee60 priority 3 vector xtintr 100 

controller xtcl at nibO csr all virt 0xebee68 priority 3 vector xtintr 101 

tape xtO at xteO drive 0 flags 1 

tape xtl at xtcl drive 0 flags 2 

device arO at rabO csr 0x200 priority 3 

[1st 1/4” tape drive. See or (4).] 


device arl at mbO csr 0x208 priority 3 

[2nd 1/4” tape drive.] 

device gponeO at tnbO csr vme busmem 0x210000 priority 3 

[Sun Graphics Processor board.] 


device cgtwoO at mbO csr vme busmem 0x400000 priority 3 

[Sun-2 color graphics interface. Required if gpone config line is present. See cgwo (4s).] 


device egoneO at itibO csr OxecOOO priority 3 
device egoneO at mbO csr vme busmem OxlecOO priority 3 
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[Sun-1 Color Board. See cgone (4s).] 

device bwtwoO at rtibO csr 0x700000 priority 4 

[1st monochrome monitor on a Sun-2/120 or Sun-2/170. See bwtwo (4s).] 

device bwtwoO at itibO csr vme obio 0x0 priority 4 

[1st monochrome monitor on a Sun-2/50 or Sun-2/160.] 

device bwoneO at mbO csr OxoOOOO priority 3 

[1st monochrome Sun-1 monitor. See bwone (4s).] 


device vpO at tnbO csr 0x400 priority 2 

[Ikon Versatec Board. See vp (4).] 

device vpcO at mbO csr 0x480 priority 2 

[1st Systech Centronics/Versatec Board. See vpc (4s).] 


device vpcl at mbO csr 0x500 priority 2 

[2nd Systech Centronics/Versatec Board.] 

device piO at inbO csr 0xee2000 

[Parallel input. Only used on Sun Models lOOU and 150U, for keyboard and mouse.] 

device desO at mbO csr all virt OxeelSOO 

[Interface to the AMD8068 Data Ciphering Processor, a hardware implementation of the NBS Data Encryption 
Standard.] 

device todO at inbO csr OxeelOOO 

[Time of day clock on the Sun-2/120 or Sun-2/170.] 


device todO at mbO csr vme busmem 0x200800 

[Time of day clock on the Sun-2/160 or Sun-2/50.] 


3.11. Uninstalling the 2.2 
Release 


NOTE 


If you run into problems while running 2.2, you can back out the changes by 
using the tape which you got after ranning 2.2_backup. You then reconfigure 
your kernel, and can run as you were before. Proceed as follows. 

Optional software is not backed out during the uninstall. 


NOTE If you are ‘uninstalling’ a network disk server, you must halt all diskless clients 

b^ore proceeding. 
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1. Load the backup tape, as described in the normal installation procedure 
above. 

2. If you have edited I etc! rc.local to contain a line for the gpconfig (8) com¬ 
mand, that file should be re-edited to remove or comment out the line. 

# /etc/shutdown -h 
>b vmunijc -a 

#/etc/nu>unt /dev/nrtapeO /usr 
#mt -f /dev/nrtapeO rew 

# tar jcvpf /dev/nrtapeO 

This takes about 30 minutes. 

4. Reconfigure your kernel. 
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Fixed Software Bugs 


4.1. Language Processors 
Assembler 

C Compiler 


FORTRAN 


This chapter briefly presents the bugs which are fixed in Release 2.2. The bugs 
are sorted under general headings; Compiler, Graphics, Kernel, Network, Utili¬ 
ties, Windows, Documentation, and Miscellaneous. As noted in the “Introduc¬ 
tion”, Release 2.2 is primarily concerned with general system bug fixes. To take 
advantage of the bug fixes in the libraries, programs should be recompiled. 


The assembler has been corrected to accept compiler lines in the 
syitibolname =. form. 

The C compiler now compiles flie assignments of address register variables to die 
bit fields. Previously, the 2.0 compiler failed to do this correctly. 

Compiler expressions in the form <expr>% 1 == 0 no longer generate an 
illegal instruction tstl #0. 

The C compiler no longer produces a fatal error message when compiling a struc¬ 
ture declaration with too many initial values. 

The C compiler has been fixed so that array subscripts no longer make it loop. In 
Release 2.0, array subscript fragments could make the C compiler loop and the 
message compiler error: expression causes compiler 
loop: try simplifying would appear. 

FORTRAN DO-loops with floating point index variables have been corrected. 
Previously, these caused compile time errors when the -f sky option was used. 

FORTRAN arithmetic expressions containing array references now compile 
correctly when using the -f sky option. Previously, these compiled incorrectly 
resulting in a segmentation fault at run time. 

The f 77 compiler generates large offsets in base displacement addressing of 
common blocks resulting in assembly time errors. This bug has been fixed. 

The bad read of list-directed floats has been fixed, list directories that read 
statements with floating point arguments use to produce incorrect results. 

A memory allocation error in the Fortran opt omi zer has been fixed. 
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4.2. Graphics 
CGI 


Pixrects 


Graphics Processor 


A syntax error in DATA statement that the compiler uses caused an abort. This 
has now been fixed. 

The -Nx option must come before the file name(s), otherwise the flag is used by 
the loader. This is not a bug in f 77 but rather a clarification. 


If a viewport is made smaller than a clip rectangle and then enlarged, the smaller 
viewport is also erJarged. Previously, when a viewport was made smaller than a 
clip rectangle, then made larger, the smaller viewport remained. 

circular_arc. 3pt returns an error message when given collinear or coin¬ 
cident points. Previously, there was no error message when this occurred. 

When five view surfaces are opened, and then one is closed, the others stay open. 
In Release 2.0, the other view surfaces could not be reopened. 

The CGI package did not free up the memory which it had allocated once it was 
done with it. 

Now when die expression within the function inquire_text_extent is set 
to the value string (which indicates raster text), the function no longer returns 
a message indicating that there is no text Previously, the function returned a 
message indicating that there was no text in this file when in fact text did exist. 

Bundled attributes now automatically rescale. They did not in the previous 
release. 

pr_rop is now working for 1-bit and n-bit memory pixrects. The bug used to 
trash the text on a retained pixwin (on a Sun-2/160 color window) when the win¬ 
dow redisplayed. 

In order to gain full screen access, a program running in a window called 
fullscreen_init calls to pw_replrop. This program will now expand 
to full screen access. Previously, it would clip to the boundries of the original 
pixwin. 

Circular arcs of width one now display on the Graphics Processor. 

The Graphics Processor no longer hangs if the number of polygon vertices is 
higlter flian 25. 

The hidden surface removal now works using the Graphics Processor without the 
Graphics Buffer. Previously, there appeared to be a hardware buffer even when 
it was not present 

A Graphics Processor device driver declaration has been added te 
/usr/include/pascal/devincpas.h. 

3-D polygons in temporary segments drawn on a gpl view surface are now 
shaded correctly. Previously, due to a bug in /usr/lib/libcore. a, the 
view surface would sometimes shade unevenly. 
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43. Kernel 

Driver 


NSF 

Miscellaneous 


A terminal on /dev/t tya that is being used as a console will no longer hang 
after the telnet gives the login message. 

The old and new tty line disciplines now control the tty line flow in raw 
mode, cbreak mode, and cooked mode. In Release 2.0, old and new tty 
line disciplines would control the tty line flow only in raw mode or 
cbreak mode, not in cooked mode. 

Sun machines with Sun Ethernet boards not plugged into a network generated 
ieO: ethernet jarnmed messages every ninety seconds if ifconfighad 
been run. Running ifconfig ieO down will now solve the problem. 

KIOCSETKEY io ct 1 no longer interacts with the keyboard translation tables 
in such a maimer that random locations in die kernel are trashed if the user 
changes the interpretation of keys. 

Heavily loaded servers sometimes locked up with processes hung waiting for 
disk I/O on a Xylogics controller. This was a hardware problem with the Xylo- 
gics 450 disk controller. The driver was modified to compensate for it. 

NFS client programs no longer cause the NFS server to panic with an address 
error. The server and client have been modified to check for negative file offsets, 

A bad block in a directory caused a server to panic when using the system call 
readdir. This bug has been fixed. 


When trying to run very large programs with very large text sizes and small data 
sizes, the system used to crash. Now, the process fails to execute. 

The bogus t race/BPT trap has been corrected. Previously, processes were 
intermittently dying during forks. 

The kernel configuration file /usr/sys/conf/ND120 has been corrected. It 
had an entry for the pseudo-device dt op which was incorrect. 

A line for iel for VME-based systems has been added to the generic kernel 
making it possible to use the generic kernel on a VME-based gateway machine. 

The kernel now recognizes bad addresses sent by user’s programs such as 
games. Previously, the kernel did not check the PTEs carefully and the system 
would panic. 

A line has been added to the GENERIC configuration file so a medium resolution 
color monitor will work with a Sun-2/160. 

The Systech mux board driver has been fixed. A bug in the driver caused the sys¬ 
tem to crash under certain error conditions, most often occurring on heavily 
loaded systems. 

The system no longer panics when it allocates a new inode in a cylinder group 
that is very full. 
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4.4. Network 


Protocol 


Yellow Pages 


Miscellaneous 


4.5. Utilities 


Miscellaneous 


The bug in UDP RPC programs that call to recvf rom after a fork has been 
fixed. 

TCP RPC programs no longer hang if the server crashs during a remote pro¬ 
cedure call. 

Gateway system’s TCP code decremented an internet packet time-to-live counter 
by too much, limiting the maximum number of hops of a TCP packet to four. 
Tliis has been fixed. 

Erroneous comparisons of usernames in the password file has been corrected. In 
Release 2.0, it caused yppasswd to think that names which were only similar 
were in fact file same. 

There was a memory leak in ypbindand ypserv; the program allocated 
memory but did not free it The bug was in the C library. 

yp_next no longer fails if the input key is zero length (null). 

/etc/yp/ypinit has been fixed. Previously, it was unable to detect an unset 
host name or domain name. 

The yp_bind function has been corrected to allow the code to work correctly 
when compiled on a DEC VAX. 

The bug in the t f tp server which caused file transfers to timeout has been 
fixed. 

Running out of process table space made a machine unable to accept new net¬ 
work coimections making programs such as rsh and r log in timeout. Under 
these circumstances, the internet daemon would eat up all the rest of the CPU 
cycles. 


The viand ex command : so (source) has been fixed. Using the source 
command to read and execute a file of vi commands caused vi to loop. 

The vtrof f formatter has been fixed. Previously, it used to generate floating 
exception messages when asked to draw boxes via -ms . BX commands. 

The error response of sendmail has been corrected. The error response of 
sendmail treated a temporary error like a permanent error. For example, the 
Release 2.0 responded Deferred: Bad file nvunber on any temporary 
error involving SMTP. 

dcheck no longer produces bogus errors after encountering a real one. 

The man command will now give the user a usage string citing the valid options 
instead of crashing. 
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4.6. Windows 

Suntools 

4.7. Miscellaneous Software 
Fixes 


The /bin/test command, used from the Bourne shell, now recognizes the 
command-line arguments -b, -c, -g, -k, and -x. 

Ipd will now parse + entries in /etc/hosts. equiv. 

The ftp bug which used to cause files to overwrite has been corrected. 

The date computation in makedbm has been fixed. 

A spurious not on export list error could result from a remote mount 
from a gateway. 


A long line of input typed to a Suntools shell window no longer locks up that 
window. 

The double pr_destroy in libsuntool/gfxsw.c has been corrected. 

In the panel_public. c package in libsuntool, in a routine named 
shrink_to_f it (), two variables have to be initialized to zero. In the 
function panel_get (), a third argument has to be defined. 

In Release 2.0, sysdiag’s account name appears in /etc/passwd with a 
blank password field. This allows over-the-wire diagnostics but also allows a 
user to log in as sysdiag and become root. If you wish to prevent this, put 
a in the password slot of passwd file. 
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The following pages list errata from the 2.0 Programmer’s R^erence Manual for 
SunCore (Part Number; 800-1165), Programmer’s Reference Manual for 
SunCGI (Part Number 800-1166), System Administration for the Sun- 

Workstation (Part Number: 800-1150) and Installing Unix on the SunWorksta- 
tion (Part Number: 800-1158). 
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Errata in the 2.0 Release 
of the 

Programmer’s Reference Manual for SunCore 


Page(s) 

Comments 

B-3 

In Section B-2, two additional device specifications for the GP board are necessary. 


gpldd A Sun-2/160 graphics display with a Graphics Processor option. 

gplpixwindd A color graphics window wifiiin the Suntools window environment 
running on a Sun-2/160 color graphics display with a Graphics Pro¬ 
cessor option. 


In addition, the sentence following these specifications that lists devices capable of 
hidden surface removal should include the new GP devices. 
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Errata in the 2.0 Release 


of the 


Programmer’s R^erence Manual for SunCGI 


Table 5-1 SunCGI Errata 

Comments 

Section 2.1.2 should state that many failures during view surface initialization produce error 11, 
ENOWSTYP. For example, opening a device surface type PIXWINDD instead of CGPIXWINDD 
on a color pixwin, or using CG2DD when the Idevicgtwo* surface is being used by sunt ools. 

In Table 2-2, an additional device specification for the GP board is necessary, 

GPIDD for Sun-2/160 graphics display with optional Graphics Processor 

Section 2.3.2.1 should contain the following explanation: 

The default state is VDC EXTENT. If clipping is not NOCUP, output primitives are clipped 
to either the clip rectangle (if cf lag equals CLIP RECTANGLE) or Ae fiill extent of VDC 
space (if cf lag equals VDC_EXTENT). The extent of VDC may be set with the 
vdc_extent function. 

In Section 2.3.3.4, the extent argument is of the enumerated type Cexttype. The function 
specification is correct, but the text makes reference to an argument clear_extent incorrectly 
of type Cclip, The definition of type Cexttype is: 

typedef enum { 

CLIP_RECT, 

VIEWPORT, 

VIEWSURFACE 
} Cexttype ; 

In Section 2.3.3.5, the discussion of set_error_warning_mask should contain the follow¬ 
ing explanation: 

SunCGI defines no errors as FATAL. (POLL and INTERRUPT actions are therefore the 
same). The error number is always returned. A message is printed unless the action is 
NO ACTION. 
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Table 5-1 SunCGI Errata — Continued 


Page 


Comments 


2-20 In Section 2.4.3 The sig_f unction argument to set_up_sigwinch is a pointer to a func¬ 
tion, The complete specification should be: 


Cerror set_up_sigwinch(name, sig_function) 

Cint name; 

Cint (*sig_function) 0; /* signal handling function */ 


The sig_f unction argument is called with a single argument: the name of the view surface 
with which it is associated by the call to set_up_sigwinch. This allows more than one view 
surface to share the same sig_f unction, and differentiate which view surface needs 
redisplay. 


3-13 Section 3.2.7 the discussion of bitblt_source_array should contain the following expla¬ 
nation: 

pixsource and pixtarget are pointers to pixrects which must already be created by 
the user with inem_creat e (see the Programmer's R^erence Manual for SunWin- 
dows ). These pixrects must be the same depth as the view surface: 1-bit deep on a 
monochrome device, 8-bit on a color device. The source area of the view surface associ¬ 
ated with name is saved into pixsource (at 0,0), possibly NOT-ed, depending on the 
drawing mode. The target area, after pixsource is applied to it, is read into pixtar¬ 
get pixrect (at 0,0). 


3-14 In Section 3.2.8, the second paragraph should say: 

pixpat is a pointer to a pixrect which must be created and initialized with die pattern 
by the application program, pixtarget is a pointer to a pixrect (with same depth as 
device) which must already be created by the user, using mem_create. The target area, 
after pixpat is applied to it, is read into the pixtarget pixrect (at 0,0). 

3-14 In Section 3.2.9, the first paragraph should say: 

bitblt_j)atterned_source_array replicates (using the current drawing mode) 
the pattern stored in pixpat to fill the area of the view surface determined by ox, oy and 
dx, dy. The source area of die view surface is read into the pixrect pointed to by pix¬ 
source (which must already be created by the user with same depth as device) at 0,0. 
The replicated pattern array is AND-ed into the pixsource, and possibly NOT-ed, depend¬ 
ing on the drawing mode. The resulting pixrect is copied to the view surface at ox, oy, 
using the current drawing mode. The target area, after the copy, is read into die pix¬ 
target pixrect If the replicated pattern array overlaps with the source array on the 
screen, the visual result depends on the current drawing mode. 


4-11 The sentence in Section 4.4.2.3 which says: 

All nonzero entries in colorind are set to 1. 
should say: 

For monochrome view surfaces, all nonzero entries in colorind are treated as 1 when 
used. 
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Table 5-1 SunCGI Errata — Continued 


Page 

4-12 New Section 4.4,2.6: 


Comments 


Cerror pattern_with_fill_color(flag) 

Cflag flag; /* ON to use nonzero pattern elements as fill color */ 

Binary patterns are a SunCGI extension that allow the same pattern to be applied in different 
colors, without redefining the pattern array, pattern_with_f ill_color sets a non¬ 
standard CGI state pattern with fill color . The default for flag is OFF and each color value in a 
pattern table entry is used verbatim, as in standard CGI. When a pattern is used while 
pattern_with_f ill_color is ON, the pattern is considered to be a 2D array of flags: 
where the pattern element is nonzero, the current fill color is used, instead of the actual value of 
the pattern element. (Where flag is zero, a zero color index is used, just as when the flag is 
OFF.) 


4- 20 Section 4,6,1 should say: 

The default color lookup table size for a color device has 8 entries. The minimum and 
maximum color table entries are treated specially by pixwins and hence by SunCGI. If 
they are set to be the same value, the user’s values for these two entries are both ignored: 
they revert to the "inverse" of the normal values: entry 0 becomes white, the maximum 
entry becomes black, 

5- 1 The following paragraphs are supplemental to the introduction of logical input devices. 

Each logical input device can be used in one of fluee ways, distinguished by the three 
EVENT input device states. To use input synchronously, tiie application program should 
caU Fequest_input. The program blocks until the operator fires a trigger associated with 
this device (or a timeout occurs). If timeout is -1, the request will wait forever. 

To receive input asynchronously, the initiate_request function should be used. 
This function initializes the device so that the measure from the next trigger activation 
will be recorded in the request register. The program does not block in REQUEST mode. 
Until the trigger fires, sainple_input may be called to get the current measure of the 
input device. After the trigger fires, get_last_request_input will then return the 
request register (value) and status. 

To use queued input the enable_e vent s function should be called. This function ini¬ 
tializes Ae device so that trigger activations will result in input events being enqueued 
onto the event queue. Calls to await_e vent will return the first event in the event 
queue. If the event queue is EMFTY^, it will wait for a trigger (or until timeout). A call K) 
disable_event s will terminate the queuing of input events. 

When initializing the locator or keyboard device, the the xypt field of the Cinrep 
structure must point to a Ccoor allocated by the application program. 
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Table 5-1 SunC GI Errata — Continued 




Page 

5-3 


_ Comments _ 

The program example in Section 5-1 is wrong. It should be replace by the following example: 


♦include <cgidefs.h> 

♦define TEN SECONDS (10 * 1000 * 1000) /* timeout is in microseconds */ 


main() 

{ 

Cawresult stat; 
Ccoor point; 
Cinrep ivalue; 
Cint name; 

Cint trig; 
Cvwsurf device; 


} 


device.dd = PIXWINDD; 

point.X = 16384; /* put cursor in the middle of the view surface */ 
point.y = 16384; 
ivalue.xypt = spoint; 


open_cgi(); 

open_vws(&name/ &device); 


initialize_lid(IC_LOCATOR, 1, &ivalue); 

/* associate locator with mouse button 1 */ 
associate(2, IC_LOCATOR, 1); 

/* track with printer's fist: move cursor (fist) to initial point 
track_on(IC_LOCATOR, 1 , 1 , (Ccoorpair *)0, &ivalue); 

/* wait up to ten seconds for input */ 

request input(IC_LOCATOR, 1^ TEN_SECONDS, &stat/ Sivalue, &trig); 
if (stat == VALID_DATA) 

printf(" trigger activated at %d %d 0, 

ivalue.xypt->x, ivalue.xypt->y); 


else 

printfC trigger not activated 0) ; 
/* shut device off */ 
dissociate(2, IC_LOCATOR, 1); 
release_input_device(IC_LOCATOR/ 1); 


*/ 


sleep(10); 
clo3e_vws(name); 
close_cgi 0 ; 


5-5 Trigger 6, LC)C_snLL, has been added. This trigger fires when the mouse doesn’t move for about 
l/5th of a second (or more). 
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Table 5-1 SunCGI Errata — Continued 


pdge _ Comments __ 

5-11 The device specification arguments for get_last_requested_input are wrong. The com¬ 

plete specification should be consistent with the other input routines. 

Cerror get last_requested._input(devclass^ devnum, valid, sample) 

Cdevoff devolass; /* device class and number */ 

Cint devnum; 

Clogical *valid; /* device status */ 

Cinrep *sample; /* device value */ 

F-2 The name and pw arguments for open_cgi_pw are wrong. The complete specification should 
be: 

Cerror open_cgi_pw(pw, desc, name) 
struct pixwin *pw; /* pixwin */ 

Ccgiwin *desc; /* CGI pixwin descriptor */ 

Cint *name; 

F-2 All cgipw input and output primitives use screen (pixel) coordinates, for compatibility with 

pixwins. As described in Programmer’s R^erence Manual for SuriWindows , pixel coordinates 
have the upper left comer as the origin for compatibility with Pixwins. Table F-1 should not con¬ 
tain reference to track_on or trac]c_off; the fimctions cgipw_track_on and 
cgipw_track_off do not exist. 

The bottom of page F-2 should say desc is a pointer to die pixwin descriptor filled in by the 
open_cgi_j5w function. 
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Table 5-1 SunCGI Errata — Continued 


_ Comments _ 

The FORTRAN example program is wrong. Here is a version that works. 

program test 
parameter (ibignum=256) 
integer name 

character screenname* (ibignum) 

integer screenlen 

character windowname* (ibignum) 

integer windowlen 

integer windowfd 

integer retained 

integer dd 

integer cmapsize 

character cmapname* (ibignum) 

integer cmaplen 

integer flags 

character ptr* (ibignum) 

integer noargs 

integer xc(10) ,yc(10) ,n 

integer xc2(2),yc2(2) 

data xc /O,-10,-1,-1,-15,15,1,1,10/0 / 
data yc /O, 0,1,20,35,35,20,1,0,0 / 
data xc2 /-12,12/ 
data yc2 /33,33/ 


call cfopencgiO 
dd = 4 

call cfopenvws(name,screenname,screenlen,windowname,windowlen, 
windowfd,retained,dd,cmapsize, 
cmapname,cmaplen,flags,ptr,noargs) 
call cfvdcext(-50,-10,50, 80) 
n = 10 

call cfpolyline(xc,yc,n) 
n = 2 

call cfpolyline(xc2,yc2,n) 

call sleep(10) 

call cfclosecgiO 

call exitO 

end 


The calling sequence for bitblt_patterned_source_arraY should say 

bitblt_j>atterned_source_array(pixpat, px, py, pixsource, 
sx, sy, pixtarget, rx, ry, ox, oy, dx, dy, name) 
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Table 5-2 Functions not compatible with CGIPW mode 


Function 

Discussion 

vdc__extent 

cgipw’s VDC space is identical to screen space 

device_viewport 

use pw region prior to open_cgi_pw 

clip_indicator 

when cfiag is CLIP_RECTANGLE 

clip_rectangle 

Instead, use pw__region prior to open_cgi_j>w 

clear_control 

All clear extents are identical 

open vws 

Use open_cgi_pw 

close_vws 

Use close_cgi_pw 

close_cgi 

Use close_jpw_cgi 


Q 


O 
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Errata in the 2.0 Release 
of the 

System Administration for the SunWorkstation 


Page (s) 

Comments 

2 

In section 1.1 of the tutorial oaFSCK-The Urax File System Check Program, the 
default block size for die 2.0 Release should be 4K with a hardcoded default block 


size of 4096. 

4-24 

In Section 4.3 when mail is sent, sendinail checks the files 
/etc/usr/hosts.equiv and /usr/lib/mailhosts for the name 
of the host to whom the mail is being sent. If neither 
of these files recognize the name, sendmail forwards the 
mail to the mailhost machine. 
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Errata in the 2.0 Release 
of the 

Installing Unix on the Sun Workstation 



Page(s) 

Comments 

3-2 

If you have a 1/4" tape and the > prompt returns instead of Boot, the tape may need 
retensioning. Try entering: 


>btape (0,0,100) 

Boot: tape (0,0,0) 

Boot: 

6-10 

If your standalone system is not attached to the net, or you are not using the yellow 
pages server, you will need to bypass the yellow pages in order to continue your 
installation of UNIX. Move /etc/ypbind to /etc/ypbind-by using the fol¬ 
lowing command: 


mv /etc/ypbind /etc/ypbind- 
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Errata in the 2.0 Release 
of the 

Installing Unix on the Sun Workstation 
Insert Sheets for Chapter 10 


5.1. Converting Diskfu! Workstations to use NFS 

This section describes how to convert a diskful workstation to use NFS. 

The NFS enables diskful workstations to mount directories from other machines, thus reducing local disk storage 
needs and allowing them to share common resources. 

The conversion process in this section is designed specifically for diskful workstations. To convert servers and disk¬ 
less clients, use the instmctions provided earlier in this chapter. 

This procedure uses examples from an upgrade where the diskfiil workstation named topnotch was upgraded to use 
NFS, and the system yfree is its NFS server. 

Use the following steps: 

(1) Record Vital Information 

Before you can proceed, you need to know: 

Your local machine name and internet address, your NFS server’s machine name and internet address, your user 
id number (uid) from letcipasswd, and your domain name if you are going to use the yellow pages . See Chapter 
1 for descriptions of these items (except uid). For example: 

topnotch 192.9.4.53 [ These are examples only 

vfree 192.9.4.54 do iwt use this information'^ 

121 


(2) Dump 

Dump your entire disk(s). 

(3) Follow Install Manual Instructions 

Follow the instructions in Chapters 1 through 5 up until the point it tells you to run setup. Then, instead of miming 
setup go to the next step. Be sure to boot the system in single user mode first: 

>b vmunix -s 


(4) Edit fstab 

Edit your letcifstab file. The entire file should look like the one below. Be sure to substitute the proper value for disk: 
Note that you may have to use the “ed” editor, as “vi” may not be available (See ed{l)). 
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/dBv/diskOa. / 4.2 rw 1 1 

/dev/diskOg /private 4.2 rw 1 2 
nfs^server name: /usr /usr nfs rw,hard 0 0 

Be sure to replace nfs_server_name with the name of your NFS server. 
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(5) Edit rc.local 

Edit the file rc.local. Replace noname with your machine name, and nodomainname with your domain name. If you 
do not use domains, leave the nodomainname alone. For example: 

/bin/hostname topnotch [Example - do not use this] 

/bin/domainname nodomainname [Note no domainname] 

(6) Edit hosts 

Add two lines with the following to your letcihosts file: 
internetjiddress machinename 

NFS_server_internet_address NFS_server_machinename 
for example: 

192.9.4.53 topnotch [TMs is an example only: 

192.9.4.54 vfree do not enter tMs data] 

(7) Add to Server’s /etc/hosts 

Make sure your internet address and machine name are in the NFS server’s letcihosts file. 

(8) Run newfs 

E>o the following !etc!newfs (remember to substimte the proper value for disk)-. 
newfs // rdiskOq 

(9) Mount diskg 

Enter the following mount command: 

/etc/mount /dev/<iisA:Og /private 

(10) Make new directories 

Use mkdir to create the following directories: 

/private 
/private/usr 
/private/usr/adm 
/private/usr/crash 
/private/usr/preserve 
/private/usr/spool 
/private/usr/tmp 
/private/usr/lib 
/private/usr/spool/mqueue 

(11) Move ypbind 

Move letclypbind to letclypbind- 

(12) Reboot your machine 

Now, prepare your machine for halting, by syncing the disks several times take it down, and boot multiuser. Note that 
the default boot command (>b) should work. 
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Try out a few things to make sure they work, before you begin the next steps and start restoring your files. 

(13) Create files 

Use touch to create the following new files; 

/private/usr/adm/lastlog 
/private/usr/adm/messages 
/private/usr/adm/msgbuf 
/private/us r/adm/shutdownlog 
/private/usr/adm/usracct 
/private/usr/adm/wtmp 

(14) Restore files 

From the dump tape you made earlier, restore your home directory files to Iusr2, which is mounted on the ’g’ parti¬ 
tion. Remember, files dumped as lusrijohn must be restored as lusrlljohn. 

Next, restore the following files individually: 

Restore lusrlliblcrontab to !private!usr!lib/crontab. 

Restore lusrilibialiases to private!usrllib!aliases. 

Restore all of /usr/spool to /private!usr!spool. 

(15) Edit crontab 

Edit the /private/usrilib!crontab file you restored and make three changes; 1) remove or comment out any find com¬ 
mand that starts at “/” — the root. 2) remove or comment out any ‘calendar’ entry. 3) Change a line in crontab as 
follows: 

Change: 

15 4 * * * find /usr/preserve -mtiine +7 -a -exec rm -f {} \; 

Change it by adding a V’ (slash) at the end of preserve; 

15 4 * * * find /usr/preserve/ -mtime +7 -a -exec rm -f {} \; 

(16) Install sendmail 

Now, you must install sendmail as described in the "System Administration Manual". Note diat the files 
!usr!lib!sendmail.main.cf &Tid !usr!lib/sendmail.subsidiary.cf should already be in /usr/lib. 

(17) Edit passwd 

Next, edit your /etc/passwd to include the uid that you recorded above, and make sure that the home directory field for 
each user is !usr2 instead of !usr. Note that eventually you will want to assign passwords to both root and yourself; 
you can do this with passwd. 

For example, make sure the field looks like this; 

zippy:OVceErnaqI: 1492:10: Zippy the Hacker:/usr 2 /zippy:/bin/csh 
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(18) Restore more files 


Now, restore the following files. Note that, unlike the files restored above, these return to their original locations. 
The files are: letciprintcap, letcittys, letcittytype, letciremote (you may have others). 

If you do not plan to use the yellow pages, then also restore the following files :! etc! group, I etc! services, 
letciprotocols, tetc!networks, and tetdhosts. 

Now, restore other files peculiar to your disk. For example, lusriliblemacs should be restored to lusr. Note however, 
that almost all programs must be recompiled; 1.x binaries do not normally run on a 2.0 system. 
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Insert Pages for 2.0 Reference Manuals 


The following pages are reference manual pages for Commands Reference 
Manual for the Sun Workstation (Part Number: 800-1172) and the System Inter¬ 
face Manual for the Sun Workstation (Part Number: 800-1173). 

How you handle the pages is up to you. We recommend inserting them directly 
into your 2.0 manuals (copying them if necessary); they are numbered accord¬ 
ingly. 


New Pages 

gpone(AS) 

gpconfigiS) 

nfsmount(2) 

nK?«nf(8) 

stiAS) 

toolplaces{l) 


— Sun-2/160 color graphics processor interface 

— initialize the Graphics Processor 

— revised 

— revised 

— revised 

— revised 
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NFSM0UNT(2) 


SYSTEM CALLS 


NFSM0UNT(2) 


Q 


NAME 


nfsmount - mount an NFS file system 


SYNOPSIS 

#include <netiDet/in.h> 
#include <nfs/nfs.li> 


nfsmount(addr, fh, dir, flags, rsize, wsize) 

struct sockaddrjn ■^addr; 

fhandle_t *fli; 

char *fireq; 

int flags; 

int rsize; 

int wsize; 


DESCRIPTION 

Nfsmount mounts an NFS(4) file system on the directory dir. Addr is the {7£)P(4) address of the server that 
owns the file system to mount. Fh is a file handle, obtained from the server, to identify the root directory 
on the server that is being mounted. 

The flags argument contains mount flag bits. The NFSMNT_RDONLY flag tells whether the file system can 
be written on; if it is 0 writing is allowed, if non-zero no writing is done. 


The NFSMNT SOFT flag determines whether the remote file system is mounted hard or soft. A soft mount 
causes an error to be returned when a remote access times out Hard mounts cause the access to retry until 
the server responds. A value of 1 indicates a soft mount. 



The NFSMNT_RSTZE and NFSMNT_WSI2E flags tell whether the rsize and wsize parameters are valid. If 
a flag is set die coresponding parameter is used to set the number of bytes sent in a read or wnte operation. 


RETURN VALUE 

Nfsmount returns 0 if the action occurred, -1 if some error occurred. 


ERRORS 

Nfsmount will fail when one of the following occurs: 

[EPERM] The caller is not the super-user or the path name given for dir contains characters with 

the high bit set. 

[ENAMETOOLONG] 

The path name for dir is too long. 

[ELOOP] Dir contains a symbolic link loop. 

[ETIMEDOUT] The server at addr is not accessable. This can only happen if the hard flag is set 
[ENOTDIR] A component of the path prefix in dir is not a directory. 

[EBUSY] Another process currently holds a reference to fh. 


SEE ALSO 

mount(2), unmount(2), mount(8) 
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GPC0NHG(8) 


MAINTENANCE COMMANDS 


GPCONnG(8) 


NAME 

gpconfig - initialize the Graphics Processor 
SYOPNSIS 

/etc/gpconfig gpunit [ [-b] [■■f\fbunit... ] 

DESCRIPTION 

gpconfig binds cgtwo firame buffers to the Graphics Processor (GP), and loads and starts the appropriate 
microcode in the GP. For example, the command line: 

/etc/gpconfig gponeO cgtwoO cgtwol 

will bind the frame buffer boards cgtwoO and cgtwol to the Graphics Processor gponeO . The devices 
IdevIgponeOa and Idev/gponeOb will then refer to the combmadon of gpone and cgtwoO or cgtwol respec¬ 
tively. 

The same cgtwo frame buffer cannot be bound to more than one GP. 

All cgtwo frame buffer boards bound to a GP must be configured to the same width and height. 

Note: The gpconfig command should be placed in the file letcirc.local if the GP is used regularly. 

Note: It is inadvisable to run the gpconfig command while the GP is being used. Unpredictable results may 
occur. If it is neccessary to change Ae frame buffer bindings to the GP (or to stop using the GP alto¬ 
gether), bring the system down gently, boot single user, and edit the gpconfig line in the letcirc.local file 
and bring the system back up multiuser. 

OPTIONS 

-b Configure the GP to use the Graphics Buffer as well. Note: Currently only one GP / frame buffer 
binding is allowed to use the graphics buffer at a time. 

-f Indicates that the next frame buffer specified is to be used for Idevifb as well. 

FILES 

/dev/cgtwo[0-9] 

/dev/fb 

/dev/gpone[0-3][abcd] 

/etc/gpicg2.1024.ucode 
/etc/gpicg2.1152.ucode 
/etc/rc.local 

SEE ALSO 

cgtwo(4S), gpone(4S) 
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M0UNT(8) 


MAINTENANCE COMMANDS 


MOUNT(8) 


NAME 

mount, amount - mount and dismount filesystems 

SYNOPSIS 

/etc/mount 
/etc/mount -p 
/etc/mount -a[fv][t type ] 

/etc/mount [ -fW][to type options ] [ fsname ] [ dir ] 

/etc/umount [ -av ] [ fsname 1 dir ]... 

DESCRIPTION 

Mount announces to the system that a filesystem/sname is to be attached to the file tree at the directory Sr. 
The directory dir must already exist It becomes the name of the newly mounted root The contents of Sr 
are hidden until the filesystem is unmounted. If fsname is of the form hostpath the filesystem type is 
assumed to be nfs{A), 

Umount announces to the system that the filesystem/rmi?n« previously mounted on directory dir should be 
removed. Either the filesystem name or the mounted-on directory may be used. 

Mount and umount maintain a table of mounted filesystems in letcimtab, described in mtab{5). If invoked 
without an argument, mount displays the table. If invoked with only one of fsname or Sr mount searches 
letcifstab for an entry whose Sr or fsname field matches the given argument. For example, 
mount /usr 
and 

mount /dev/xyOg 
are shorthand for 

mount /dev/xyOg /usr 
if this line is in letcifstab 

/dev/xyOg /usr 4.2 rw 11 

MOUNT OPTIONS 

-a Attempt to mount all the filesystems described in letcifstab. In this case,/jnome and Sr are taken 
from letcifstab. If a type is specified all of the filesystems in letcifstab with that type will be 
mounted. 

-o The next argument is a string that specifies mount options. Valid options are; ro, rw, quota, 
noquota, hard, soft, rsize=n, and wsize=n. Hard, soft, rsize=n and wsize=n only make sense on 
n/j(4) filesystems. Options are separated by commas. The options ro and rw stand for read-only 
and read-write; rw is,the default Since quotas are not implemented, noquota is the default. With 
a hard remote mount, mount tries forever if the mountd(8c) server does not respond. Once the 
filesystem is mounted, access requests will retry forever if the nfsd(^) server does not respond. 
Hard is the default. With a soft remote mount, if the mountdt^) server does not respond, mount 
forks a background copy to retry forever. Once the soft mount completes, access requests will fail 
with [ETIMEDOUT] if the n/sd(8) server does not respond. The rsize^n and wsize=n options can 
be used to set the number of bytes in a read or write operation on nfs(4) filesystems. 

-r Mount the specified filesystem read-only. This is a shorthand for; 

mount -0 TO fsname dir 

Physically write-protected and magnetic tape filesystems must be mounted read-only, or errors 
will occur when access times are updated, whether or not any explicit write is attempted. 

-t The next argument is the filesystem type. The accepted types are; 4.2, nfs, and pc; stofstab(5) for 
a description of the legal filesystem types. 

-f Fake a new letcimtab entry, but do not actually mount any filesystems. 

—p Print the list of mounted filesystems in a format suitable for use in letcifstab. 

-v Verbose — mount displays a message indicating the filesystem being mounted. 
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MOUNT (8) 


MAINTENANCE COMMANDS 


MOlINT(8) 


UMOUNT OPTIONS 

-a Attempt to unmount all the filesystems currently mounted. In this case, fsname is taken from 
letcimtab. 


-V Verbose — umount displays a message indicating the filesystem being unmounted. 


EXAMPLES 

mount /dev/xyOg /usr 
mount -ft 4.2 /dev/hdO / 
mount-at 4.2 

mount-tnfs serv:/usr/src /usr/src 
mount serv:/usr/src /usr/src 
mount -o hard serv:/usr/src /usr/src 
mount-p > /etc/fstab 


mount a local disk 
fake an entry for nd root 
mount all 4.2 filesystems 
mount remote filesystem 
same as above 

same as above but hard mount 
save current mount state 


FILES 

/etc/mtab mount table 

/etc/fstab filesystem table 


SEE ALSO 

mount(2), nfsmount(2), unmount(2), fstab(S), mountd(8c), nfsd(8c) 


BUGS 

Mounting filesystems full of garbage will crash the system. 

No more than one user should mount a disk partition "read-write" or the file system may become corrupted. 


539b 


Last change: 12 March 1985 


Sun Release 2.2 




GP0NE(4S) 


SPEQALFE^S 


GP0NE<4S) 


^^NAME 

gpone - Sun-2/160 color graphics processor interface 
SYNOPSIS 

gponeO at mbO csr vme busmem 0x210000 priority 3 
DESCRIPTION 

The gpone interface provides access to the optional GP graphics processor board. 

gpone supports the FBIOGTYPE iocti which a program can use to inquire as to the characteristics of the 
(fcplay device; see/bw (4s). 

gpone suRWits the FBIOGPIXRECT iocti which allows SunWindows to run on it; seefbio (4s). 

The hardware consumes 64 kilobytes of VME bus address space. The GP board starts at standard address 
0x210000 and must be configured for interrupt level 3. 

FILES 

/dev/gpone[0-3][abcd] 

SEE ALSO 

fbio (4s), mmap (2) 
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Appendix H: for the Programmer's 
Reference Manual for SunWindows 

The following pages are to be inserted as an appendix to the Programmer's 
Reference Manual for SunWindcws. 

The SunWindows software provides a rich basis for designing custom user- 
interfaces. With the window system, the programmer can share the screen’s "real 
estate" amongst several virtual screens called windows. Each of these windows 
is essentially its own state machine, and so windows can be sensitive to program¬ 
mer specified input events and take any number of actions in response to the 
events. Most of the time an input eventually results in some change in the win¬ 
dow itself— sometimes drawing or writing something new in the window, and 
other times changing the window’s state with respect to the entire window sys¬ 
tem. 

With software this sophisticated, sometimes it is hard at first to get a handle on 
the data structures and library routines that make up the windows system. We 
feel that programming examples are the best way to show how to access specific 
data structures and call specific routines. Also, programming examples often 
give a good sense of what SunWindows is intended to do. The Programmer's 
Tutorial to SunWindows gives several good examples for beginners. 

This document is meant as a supplement to the Tutorial with more advanced 
examples. None of tite programs are useful except as examples of a specific facet 
of SunWindows. They are designed to be short and to the point. The program 
listings included cover the following subjects; 

oHow to use timers in a tool_select () call {timertool .c) 

□ How to change icons dynamically (changing_icon. c) 

D How to find newly exposed area in a window after window damage occurs 
(rectlists.c) 

□ How to customize subwindow layout in a window (layout. c) 

□ How to manipulate the colormap and color bit-planes in a color window 
(onewaytomakeacolorbar.c, 

anotherwaytomakeacolorbar.c, animation.c) 

□ How to use the tool_parse_all (} call (parse_all. c) 

□ How to find the root window file descriptor from any window 
(findroot.c) 
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Each program has approximately fifty lines of code (not counting comment lines, 
of course), many of which are copied from one program to the next. We suggest 
typing in the programs to help familiarize yourself with the data stractures and 
calls, and so you can see the programs work. Further, we hope you use these pro¬ 
grams as building blocks for your own experimentation with the window system. 
Each program contains comments explaining how the program works in general. 
For more information on data structures and routines used, please refer to the 
SunWindows Reference Manual . 

This program illustrates how to use subwindow timers. These are briefly 
described in Section 6.3.1 of the SunWindows Reference Manual. 

Each subwindow is described by a tool sw structure. One field in that stmc- 
ture is a pointer to a t oolio structure; one of the fields in THAT struct is a 
pointer to a timeval structure. A timeval has the following definition (see 
/usr/include/sys/time.h): 


struct timeval { 

long tv_sec; 
long tv_usec; 

}; 


t v_sec and tv_usec specify a number of seconds and microseconds. 

In a toolio, the timeval pointer field is called tio_timer . Ordinarily its value 
is NULL. When its value is non-null, then the timeval gives an amount of time 
for tool_select to wait for input events in the relevant subwindow. If the timer 
expires before an input event occurs, then control passes to the subwindow’s 
selected routine, just as if there had been an input event. The way to tell whether 
it was an input event or a timeout that activated the selected routine is to check 
the fields in timeval. They are dynamically decremented, so if they are both 
zero you know that a timeout has happened. 

This tool has a single subwindow. When you click the left mouse button, it 
activates a half-second timer in the subwindow. When the timer times out, the 
cursor image is changed and the timer is restarted. This goes on until you click 
the left mouse button again, at which point the tool goes into its original state, 
waiting for a click but not timing anything. 


To compile: 


cc timertool.c -o timertool -Isuntool -Isunwindow -Ipixrect 
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♦include <stdio.h> 

♦include <suntool/tool_h3.h> 
♦include <suntool/in3gsw.h> 

♦define TIMING l' 

♦define NOT_TIMING 2 

struct tool *tool; 

struct toolsw *subwin; 

struct msgsubwindow *rnsw; 

struct pixfont *font; 

struct inputmask im; 

struct timeval tiineval; 

int sigwinchcatcher () , selectedO; 

int state; 

struct cursor *cursor_array[8]; 
int cursor index; 


/* Values for "state" */ 


/* The tool */ 

/* The subwindow */ 
/* Ditto */ 


/* Pointers to 8 possible cursors */ 
/* Index of current cursor (0-7) */ 


/* The cursors. See section 4.8.1. of the SunWindows Manual. */ 
DEFINE_CURSOR(curO, 7, 1, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF, 
OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(curl, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,0xFE7F, 
0xFE7F,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur2, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,0xFC3F,OxFCSF, 
0xFC3F,0xFC3F,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur3, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,0 xF8IF,OxF 8IF,OxF 8IF, 
OxFSlF,0xF81F,0xF8lF,OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur4, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,OxFFFF,OxFOOF,OxFOOF,OxFOOF,OxFOOF, 
OxFOOF,OxFOOF,OxFOOF,OxFOOF,OxFFFF,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur5, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxFFFF,0xE0O7,OxE007,0xE007,OxE0O7,0xE007, 
0xE007,OxEOO7,OxE0O7,OxE0O7,OxEO07,OxFFFF,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur6, 7, 7, PIX_SRC, 

OxFFFF,OxFFFF,OxC003,OxCOOS,0xC003,OxC003,OxC003,OxC003, 
0xC003,OxC003,OxC003,0xC003,0xC003,OxCO03,OxFFFF,OxFFFF); 
DEFINE_CURSOR(cur7, 7, 7, PIX_SRC, 

OxFFFF,0x8001,0x8001,0x8001,0x8001,0x8001,0x8001,0x8001, 
0x8001,0x8001,0x8001,0x8001,0x8001,0x8001,0x8001,OxFFFF); 

main 0 

{ 

state = NOT_TIMING; 
font = pw_pfsysopen(); 

/* Create the tool. */ 
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tool = tool^make (WIN__LABEL, "Timer Example", 0); 
if (tool == NULL) { 

fputs("Can't make the tool.O, stderr)? 
exit(1); 

} 

/* Create and init the subwindow. */ 
subwin = msgsw_createtoolsubwindow(tool, 

TOOL_SWEXTENDTOEDGE, TOOL_SWEXTENDTOEDGE, 

"Click left button to start timing operation.", font); 
if (subwin == NULL) { 

fputs("Can't make the subwindow.0, stderr); 
exit(2); 

} 

msw = (struct msgsubwindow *)subwin->ts_data; 
subwin->ts_io.tio_selected = selected; 

/* Set up input mask to respond to left-button clicks. */ 
input_imnull(&im); 
win_setinputcodebit(&im,MS_LEFT); 

win_setinputmask(subwin->ts_windowfd, &im, NULL, WIN_NULLLINK); 

/* Init the array of cursor-pointers. */ 

cursor_index =0; 

cursor_array[0] = &cur0; 

cursor_array[1] = &curl; 

cursor_array[2] = &cur2; 

cursor_array[3] = &cur3; 

cursor_array[4] = &cur4; 

cursor_array[5] = &cur5; 

cursor_array[6] = &cur6; 

cursor_array[7] = &our7; 

/* Install the tool */ 
signal(SIGWINCH, sigwinchcatche r); 
tool_install(tool); 

/* Main loop. */ 
tool_seleot(tool,0); 

/* Clean up */ 
tool_destroy(tool); 
exit(0); 



In this routine, there is a left-button click, or a timeout 

If you are in NOT TIMING state, then it can only have been a click. In this case 
go to TIMING state and set up the timer for 1/2 second (500,000 microseconds). 


If you are in TIMING state, you will have to figure out if you got a timeout or a 
click. As mentioned above, you do this by seeing if both fields in the t imeval 
are zero. If so, restart the timer and change the cursor. If not, de-activate the 
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timer and switch to NOT_TIMING state. 


selected() { 

struct inputevent ie; 


} 


if (state == NOT_TIMING) { 

input_readevent(subwin->ts_windowfd, &ie); 

state = TIMING; /* Change state */ 

tinieval.tv_sec = 0; 

timeval.tv_usec = 500000; 

subwin->ts_io.tio_^timer = fitimeval; /* Start timer */ 

msgsw_setstring(msw, 

"Click left button to halt timing operation."); 


} ■ 

else { /* timing state */ 

if (timeval.tv_sec == 0 && /* If got timeout */ 

timeval.tv_usec == 0) { 

timeval.tv_usec = 500000; /* Restart timer */ 

cursor_index = (cursor_index+l) % 8; /* Update */ 

win_setcursor(subwin->ts__windowfd, /* the */ 

cursor_array[cursor_index]); /* cursor */ 

} 

else { /* Not timeout, must be click */ 

input_readevent(subwin->t3_windowfd, &ie); 
subwin—>t 3 io.tio_timer = NULL; /* Deactivate timer */ 
state = NOT_TIMING; /* Change state */ 

msgsw_setstring(msw, 

"Click left button to restart timing operation."); 

} 

} 


/* Standard SIGWINCH handler. */ 
sigwinchcatcher() 

( 

tool_sigwinch(tool); 


This program illustrates how to create an icon without the icontool facility, 
and how to change it dynamically. 

The icon’s image is a 64x64 pixrecL After we create it and draw in it (the image 
is a simple checkerboard pattern), we set up an icon structure. When we create 
the tool, we specify a pointer to that icon structure. 

The tool consists of a single message subwindow. We set up a half-second timer 
in the subwindow. Please see timertool.c elsewhere in this package for details on 
using timers. When the timer goes off, we check to see if the tool is in iconic 
form. If so, we toggle the icon’s image by XORing its pixrect with an all-l’s 
pattern. 
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To compile: 

:cc changing_icon.c -o changing_icon -Isuntool -Isunwindow -Ipixrect 


#include <stdio.h> 

#include <suntool/tool_hs.h> 
#include <suntool/msgsw.h> 


struct tool *tool; 

struct toolsw *msw; 

struct pixfont *font; 

struct icon icon; 

struct pixrect *icon_mpr; 

struct timeval timeval; 

int sigwinchcatcher() , selected(); 


/* The tool itself */ 

/* The message subwindow */ 

/* Font for writing in msg subwindow */ 
/* The icon. */ 

/* Memory pixrect for the icon */ 

/* The timer */ 



main(argc,argv) 
int argc; 
char **argv; 

{ 

/* Create and init the icon's memory pixrect. */ 
icon_mpr = mem_create(64, 64, 1); 
if (icon_mpr == NULL) { 

printf("Aborting: cannot create icon's memory pixrect.0); 
exit(1); 

}; 

pr_rop (icon_mpr, 0,0,32,32, PIX__SET, NULL, 0,0); 
pr__rop (icon_mpr, 32,32,32,32, PIX_SET, NULL, 0,0); 


/* Init the icon. */ 

icon.ic_width = icon.ic_height = 64; 
icon.ic_background = NULL; 
icon.ic_gfxrect.r_left = 0; 
icon.ic_gfxrect.r_top = 0; 
icon.ic_gfxrect.r_width = 64; 
icon.ic_gfxrect.r_height = 64; 
icon.ic_mpr - icon_mpr; 
icon.ic_textrect.r_left =0; 
icon.ic_textrect.r_top =0; 
icon.ic_textrect•r_width =0; 
icon.ic_textrect.r_height = 0; 
icon.ic_text = NULL; 
icon.ic_font ■= NULL; 
icon.ic_flags = ICON_BKGRDGRY; 



/* Create the tool struct. */ 

tool = tool create("Changing-Icon Tool", TOOL_NAMESTRIPE, NULL, sicon); 
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if (tool == NULL) { 

printf("Aborting: cannot create tool.O); 
exit(1); 

} 


/* Create and init the subwindow. */ 
font = pw__pfsysopen 0 ; 

msw = msgsw_createtoolsubwindow (tool, TOOL_SWEXTENDTOEDGE, 
TOOL_SWEXTENDTOEDGE, "Please make me iconic.", font); 
if (msw == NULL) { 

printf("Aborting; cannot create subwindow.0); 
exit (1); 

} 

msw->ts_io.tio_selected = selected; 

timeval.tv_sec =0; /* Set up the timer */ 

timeval.tv_usec = 500000; 
msw->ts io.tio timer = Stimeval; 


/* install the tool */ 

signal(SIGWINCH, sigwinchcatcher); 

tool install(tool); 


/* Main loop. */ 
tool_select(tool,0); 


/* clean up */ 
tool_destroy(tool) ; 
exit (0); 


} 


/* Routine to handle SIGWINCH. */ 
sigwinchcatcher() 

{ 

tool_sigwinch(tool); 

} 

This is the selected routine. Since there is no input mask to select any input 
events, the oidy way to get here is if the timer times out. We restart the timer 
and, if the tool is in iconic state, we invert the icoa In order to update the icon’s 
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image as it appears on the screen, we have to call tool_display. (See p. 6-8 
of the SunTools Manual for an explanation of the tl_f lags field in the tool 
struct; we check this field when we see whether or not the tool is iconic. See p. 
6-22 for an explanation of tool_ciisplay.) 

selectedO { 

timeval.tvjusec = 50(X)00; if ((tool->tl_flags & TOOL_ICONIC) == 0) retum(0); 

timeval.tv_usec = 500000; 

pr_rop(icon_mpr,0,0,64,64,PIX_NOT(PIX_DST),NULL,0,0); 

tool_display(tool); } 


This program demonstrates how to find out where a window has been 
damaged. "Damage" occurs either because the window size has changed 
or because windows above the window this program makes go away. 

For more information, see Chpt. 3 and Appendix A of the SunWindows 
Reference Manual (Revision G -- 2.0 release). 

Each time this program recieves a SIGWINCH, it clears the entire 
window, loads in the clip list which tells what window "real estate" 
has been exposed, and draws boxes around each new piece of real 
estate. 

This is the technique used by a program like the shelltool to repaint 
after window damage occurs. In a tty subwindow, a buffer of all the 
characters on the screen is maintained. When the rectlist indicates 
there is new exposed area in the window, the tty subwindow translates 
the comers of the damage in pixel coordinates to the comers in row 
and column coordinates. Then it simply re-writes the rows and columns 
that have been exposed. You can observe this by covering and uncovering 
a shelltool and watching the way it re-paints. 
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To compile: 

machine% cc rectlists.c -o rectlists -Isuntool -Isunwindow -Ipixrect -Im 

tinclude <stdio.h> 

#include <suntool/tool_hs.h> 

#include <suntool/gfxsw.h> 

main(argc, argv) 
int argc; 
char **argv; 


int height, width, vertical_line “0; 

int xO, xl, yO, yl; 

struct rect rect; 

struct rectnode *rectnode; 

struct rectlist *rectlist; 

/* set up a graphics subwindow */ 

struct gfxsubwindow *gfx = gfxsw__init (0, argv); 

struct pixwin *win = gfx->gfx_pixwin; 

for (;;) { 

if (gfx->gfx_flags & GFX__DAMAGED) { 

/* check if window size changed */ 
height = win_getheight(gfx->gfx_windowfd); 
width = win_getwidth(gfx->gf x_windowfd); 

/* clear the window */ 

pw_writebackground(win, 0, 0, width, height, PIX_CLR); 

/* set up new clip list & lock window during fix */ 
pw_damaged(win); 

rectlist = &win->pw_clipdata->pwcd_clipping; 
rl_rectoffset(rectlist, &rectlist->rl_bound, Srect); 
pw_lock(win, &rect); 

/* check if a window has been removed */ 
for (rectnode = rectlist->rl_head; 

rectnode; rectnode = rectnode->rn_next) { 

rl_rectoffset(rectlist, &rectnode->rn_rect, 
Srect); 

/* draw a square around this rect */ 

xO = rect-r_left; 

xl = rect__right (Srect); 

yO = rect.r_top; 

yl = rect_bottom(&rect); 

pw_vector(win, xO, yO, xO, yl, PIX_SET, 1); 
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pw vector(win. 

xO, 

n. 

xl. 

yi. 

PIX_ 

SET, 

1); 

pw_vector(win. 

xl. 

yi. 

xl. 

yO, 

PIX~ 

[set. 

1); 

pw vector(win. 

xl. 

yo, 

xO, 

yO, 

PIX__ 

_SET, 

1); 


/* done, so unlock, clear flag, and undo rectlist */ 
pw_unlock(win); 

gfx->gfx_flags &= ~GFX_DAMAGED; 
pw_donedamaged(win); 

/* give the user some idea what to do */ 
vertical_line +=20; 

if {vertical_line > height) vertical_line = 20; 
pw_text(win, 20, vertical_line, PIX_SRC, NULL, 

•’Put windows on this window, and then take them off I") 



#ifndef lint 

static char sccid[] = "0(#)layout.c 2.0 85/05/20 Copyr 1985 Sun Micro"; 
#endif 

This program illustrates how to defeat the default tiling 
algorithm, which as of 2.0 leaves much to be desired. A major 
problem is that you can’t lay out subwindows in a tool like this: 
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Section 6.2.5 of the SunWindows Reference Manual says 
that what you need to do is write your own routine named 
tooI_Iayoutsubwindows(tooI). At link time, this routine will 
supersede the routine provided in the suntool.a library. The 
user-supplied version should set up rects to describe the desired 
layout (one rect per subwindow), and enforce the rects with calls 
to win_setrect, which is documented in section 4.3. 

The only tricky part is figuring out what the coordinates 
and sizes (which you put in the rects) refer to: should you or 
should you not figure in the borders? Here’s the low-down. The 
Width and height of the tool (specified in tool_make) include the 
top namestripe (16 pixels) and the top, left, bottom, and right borders 
(5 pixels each: 2 black, then 1 white, then 2 more black). Moreover, 
in order for things to look right, there should be 5 pixels in 
between all subwindows. All coordinates are relative to the top-left 
comer of the tool (i.e. the first pixel in the namestripe); 
dimensions do NOT include borders. Thus the first subwindow goes 
at (5,18). 

Note that instead of using explicit values for the size of the 
namestripe, border width, and spacing, we could have used the 
functions tool_stripeheight (), tool_borcierwicith ()FP, and 
tool_subwindow_spacing(). These are described in section 6.2.5 of the 
SunWindows Reference Manual. 

To compile: 

cc layouLc -o layout -Isuntool -Isunwindow -Ipixrect 
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#include <stdio.h> 

#include <suntool/tool_hs.h> 
#include <suntool/msgsw.h> 

struct tool *tool; 

struct toolsw *swl, *3w2, *sw3; 

struct pixfont *font; 


/* The tool. */ 

/* The subwindows. */ 

/* Font for writing in subwins. */ 


Routine to handle SIGWINCH. Nothing special. */ 
sigwinchcatcher 0 

{ 

tool_sigwinch(tool); 

} 



main(argc,argv) 
int argc; 
char **argv; 

{ 

/* Create the tool. */ 

tool = tool_make(WIN_LABEL, argv[0], 

WINJWIDTH, 500, 

WIN_HEIGHT, 428, 

0 ); 

if (tool “= NULL) { 

printf("Aborting; cannot create tool.O); 
exit(1); 


); 



font = pw_pfsysopen0; 

/* Create 3 subwindows. Dimensions don't matter, since we're */ 

/* going to override them and the tiling algorithm. */ 

swl = msgsw_createtoolsubwindow(tool, 

TOOL_SWEXTENDTOEDGE, 100, 

"This is the first subwindow.", font); 

sw2 = msg3w_createtoolsubwindow(tool, 

TOOL_SWEXTENDTOEDGE, 100, 

"This is the second subwindow.", font); 

sw3 = msgsw_createtoolsubwindow(tool, 

TOOL_SWEXTENDTOEDGE,TOOL_SWEXTENDTOEDGE, 

"This is the third subwindow.", font); 

if (swl==NULL 1 I sw2==NULL || sw3==NULL) { 
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}; 


printf("Aborting: 
exit(2); 


cannot create subwindows.0); 


/* Install the tool */ 

signal(SIGWINCH, sigwinchcatcher)/ 

tool_install(tool); 

/* Main loop. */ 
tool_select(tool,0); 

/* Clean up */ 
tool_destroy(tool); 
exit(0); 


This is our customized version of the layout algorithm. All 
we do is format rects to tell the subwindows where we really 
want them to go. 


tool_layoutsubwindows(t) 
struct tool *t; 

{ 

struct rect recti, rect2, rect3; 

recti.r_left = 5; 
rectl.r_top = 18; 
recti.r_width = 100; 
recti.r_height = 200; 

win_setrect(3wl->ts_windowfd, Srectl); 

rect2.r_left = 5; 

rect2.r_top = 223; 

rect2.r_width = 100; 

rect2.r_height = 200; 

win_setrect(3w2->ts_windowfd, &rect2); 

rects.r_left = 110; 

rect3.r_top = 18; 

rects.r_width = 385; 

rects.r_height = 405; 

win_setrect(sw3->ts_windowfd, &rect3>; 

} 



lifndef lint 

static char sccid[] = "0(#)onewaytomakeacolorbar.c 2.0 85/05/20 Copyr 1985 Sun Micr 
lendif 
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colonnap experimentation — how to manipulate colormap and bit-planes 

This program draws 2**n bars of different colors (0 <= n <= 8). It 
loads a gray-scale colonnap, enables all the bit-planes it needs for 
the number of bars it is about to draw, and then draws the bars. 

Remember, in the window system, all colors will show up in any given 
window only when the mouse is in that window. 
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To compile: 

cc onewaytomakeacolorbar.c -o onewaytomakeacolorbar -Isuntool -Isunwindow -Ipixrec 

tinclude <stdio.h> 
tinclude <suntool/tool_hs.h> 
finclude <suntool/gfxsw.h> 

main(argc, argv) 
int argc; 
char **argv; 


struct gfxsubwindow *gfx = gfxsw_init(0, argv); 
struct pixwin *win = gfx->gfx_pixwin 7 
unsigned char red[256], green[256], blue[256]; 
int colors, i, height, width, planes; 
char maps[20]; 

for (;;) { 

for (colors=2; colors<257; colors *= 2) [ 

printf("Number of colors: %d0, colors); 
planes = colors-1; 

/* generate a colormap with 'colors' entries where the 
0th entry is black and the color'th entry is white 
with a gray scale in the intervening values*/ 
for (i=0; Kcolors; i++) { 

red[i] = green[i] = blue[i] = i*255/(colors-1); 

) 

/* find the dimensions of the rect */ 
height = win_getheight(gfx->gfx_windowfd); 
width = win_getwidth(gfx->gf x_windowfd); 

/* make up a colormap name and load it */ 
sprintf(maps, "testcolor%d", colors); 
pw_setcmsname(win, maps); 

/* put in the colormap we made above */ 
pw_putcolormap(win, 0, colors, red, green, blue); 

/* enable all the bit-planes used */ 
pw_putattributes(win, fiplanes); 

/* clear the window */ 

pw_write(win, 0, 0, width, height, PIX_CLR, NULL, 0, 0); 

/* determine the width of the colorbars */ 
width /= colors; 
if (width < 1) width = 1; 
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/* draw the colorbars — one for each color we're displaying */ 
for (i=0; i<colors; i++) { 

pw_write(win, i*width, 0, width, height, 
PIX_SRC!PIX_COLOR(i), NULL, 0, 0); 

} 

sleep(3); 

/* make and insert the inverse colormap of the first one 
we made */ 

for (i=0; i<colors; i++) { 

red[i] = green[i] = blue[i] = 255 - (i*255/(colors-1)); 

} 

pw_putcolormap(win, 0, colors, red, green, blue); 
sleep(3); 


} 

} 

} 

tifndef lint 

static char sccid[] = "@(#)anotherwaytomakeacolorbar.c 2.0 85/05/20 Copyr 1985 Sun 
#endif 

o 

colormap experimentation — another way to manipulate colormap and bit-planes 

This program draws 2**n bars of different colors (0 <= n <= 8). It 
loads a gray-scale colormap and then draws the colorbars. In this 
version, the programs tries to write to all the bit-planes each time 
it writes a bar. However, before it writes the bar, it only enables 
the proper set of bit-planes for the color it wants to draw. 

Remember, in the window system, all colors will show up in any given 
window only when the mouse is in that window. 
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To compile: 



cc anotherwaytomakeacolorbar.c -o anotherwaytomakeacolorbar -Isuntool -Isunwindc 

#include «stdio.h> 

#include <suntool/tool_hs.h> 
tinclude <suntool/gfxsw.h> 

main(argo, argv) 
int argc; 
char **argv; 


struct gfxsubwindow *gfx = gfxsw_init(0, argv); 
struct pixwin *win = gfx->gfx_pixwin; 
unsigned char red[256], green[256], blue[256]; 
int colors, i, height, width, planes; 
char maps[20]; 

for (;;) [ 

for (colors=2; colors<257; colors *= 2) [ 

printf("Number of colors: %d0, colors); 
planes = colors-1; 

/* generate a colormap with 'colors' entries where the 
0th entry is black and the color'th entry is white 
with a gray scale in the intervening values*/ 
for (i=0; Kcolors; i++) { 

red[i] = i*255/(colors-1); 
green[i] = 255 - (i*255/(colors-1)); 
blue[i] = 250; 

} 

/* find the dimensions of the rect */ 
height = win_getheight(gfx->gfx_windowfd); 
width = win_getwidth(gfx->gfx_windowfd); 

/* make up a colormap name and load it */ 
sprintf(maps, "testcolor%d", colors); 
pw_setcmsname(win, maps); 

/* put in the colormap we made above */ 
pw_putcolormap(win, 0, colors, red, green, blue); 

/* enable all the bit-planes used */ 
pw_putattributes(win, fiplanes); 

/* clear the window */ 

pw_write(win, 0, 0, width, height, PIX_CLR, NULL, 0, 0); 
/* determine the width of the colorbars */ 


o 
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width /= colors; 
if (width < 1) width =1; 

/* draw the colorbars — one for each color we're displaying 
Note: this time we write out to all the bit-planes with 
the pw_write() call, but we only enable some of the 
bit-planes. This is a different way of making colors */ 
for (i=0; Kcolors; i++) { 
planes = i; 

pw_putattributes(win, Splanes); 
pw_write(win, i*width, 0, width, height, 

PIX_SET, NULL, 0, 0); 

1 


sleep(3); 



/* make and insert the inverse colormap of the first one 
we made */ 

for (i=0; i<colors; i++) { 

red[i] = 255 - (i*255/(colors-1)); 
green[i] = i*255/(colors-1); 
blue[i] = 250; 

} 

pw_putcolormap(win, 0, colors, red, green, blue); 
sleep(3); 


} 

} 

} 

tifildef Unt static char sccid[l = "(g)(#)animation.c 2.0 85/05/20 Copyr 1985 Sun Micro"; #endif 


Copyright (c) 1985 by Sun Microsystems, Inc. 

Move a square around the screen randomly — a random walk 

This program uses "animation", a technique of displaying one bit-plane while 
drawing to another. This gives the appearance of smooth change from one 
image to the next. You can sort of see what animation looks like widiout 
multiple bit-planes if you run this program on a monochrome display. 

A good exercise, however, is to modify this program slightly to use only 
one bit-plane so you can see die difference between smooth multi-plane 
and jumpy single-plane animation. 


o 
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To compile: 

machine% cc animation.c -o animation -Isuntool -Isunwindow -Ipixrect 



finclude <stdio.h> 

#include <suntool/tool_hs.h> 
finclude <suntool/gfxsw.h> 

#define RECTX 20 
#define RECTY 35 

/* declare all the functions we use to generate random walk */ 
long random(), getpid(); 
int srandomO; 

main(argc, argv) 
int argc; 
char **argv; 


{ 


int posx, posy; 

int old_posx, old_posy; 

int planes; 

int height/ width; 

#define BCKRND 230 
fdefine BCKGRND BCKRND-10 



/* set up two color maps, redO, greenO, blueO, and redl, greenl, 
bluel */ 

static unsigned char red0[4] = (0, BCKRND, 0, BCKRND}; 

static unsigned char green0[4] = {0, BCKRND, 0, BCKRND}; 

static unsigned char blue0[4] = {BCKGRND, BCKGRND, BCKGRND, BCKGRND}; 

static unsigned char redl[4] = {0, 0, BCKRND, BCKRND}; 

static unsigned char greenl[4] = {0, 0, BCKRND, BCKRND}; 

static unsigned char bluel[4] = {BCKGRND, BCKGRND, BCKGRND, BCKGRND}; 

/* set up a graphics subwindow */ 

struct gfxsubwindow *gfx = gfxsw_init(0, argv); 

struct pixwin *win = gfx->gfx_pixwin; 

/* initialize the randomizing variable */ 
srandom((int)(getpid())); 


/* set the colormap name */ 
pw_setcmsname(win, "animate"); 


Restart: 
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/* window size may have changed, so get current coordinates */ 

width = win_getwidth(gfx->gfx_windowfd); 

height = win_getheight(gfx->gfx_windowfd); 

old_posx = posx = width/2; 

old_posy = posy = height/2; 

/* put in the redl, greenl, bluel colormap */ 
pw_putcolormap(win, 0, 4, redl, greenl, bluel); 

/* clear the window */ 
planes = 3; 

pw_putattributes<win, Splanes); 

pw__write(win, 0, 0, width, height, PIX_NOT(PIX_SRC), NULL, 0, 0); 

/* do some initialization */ 
planes = 1/ 

pw_putattributes(win, Splanes); 

pw_write(win, posx, posy, RECTX, RECTY, PIX_SRC, NULL, 0, 0); 
planes =2; 

pw_putattributes(win, Splanes); 

/* draw the thing zillions of times */ 
for (;;) { 

/* check for damage */ 

if (gfx->gfx_flags&GPX_DAMAGED) gfxsw_handlesigwinch(gfx); 
if (gfx->gfx_flags&GFX_RESTART) { 

gfx->gfx_flags &= ~GFX_RESTART/ 
goto Restart; 

} 

/* draw the next square */ 

pw_write(win, posx, posy, RECTX, RECTY, P1X_SRC, NULL, 0, 0); 

/* swap colormaps so the polygon just drawn shows and 
the polygon about to be drawn won't show */ 
if (planes == 2) { 

pw_putcolonnap(win, 0, 4, redl, greenl, bluel); 
planes =1; 

} else { 

pw_putcolorniap(win, 0, 4, redO, greenO, blueO) ; 
planes =2; 

} 

/* wipe out the old square */ 

pw_putattributes(win, splanes); 

pw_write(win, old_posx, old_posy, RECTX, RECTY, 

PIX_N0T(PIX_SRC), NULL, 0, 0); 
old_jposx = posx; 
old_j>osy = posy; 

/* determine the next posx and posy */ 
if (randomO < 1073741824) { 
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posx -= randomO/268435456 + 1; 

} else { 

posx += randomO 7268435456 + 1; 

} 

if (randomO < 1073741824) { 

posy -= randomO 7268435456 + 1; 

} else { 

posy += randomO 7268435456 + 1; 

} 

if (posx < 0) posx = width-1; 
if (posx > width) posx = 0; 
if (posy < 0) posy = height-1; 
if (posy > height) posy =0; 

} 

) 


#ifndef lint 

static char sccid[] = ”@(#)parse_all.c 2.0 85705720 Copyr 1985 Sun Micro"; 
#endif 

This program illustrates correct use of the "tooljparse_aH" 
call, which is used to extract tool-related command line options 
from argv. 

After we call "tool_parse_all", all parameters left in argv are 
suitable for parsing. All we do is concatenate them in a string 
which we display in a message subwindow. Note the use of 
"tool_ftee_attributeJist", which releases resources grabbed by 
"tooljparse_air'. 

To see the tool in action, type '’parse all", followed by several 
command line options. Some of these should be tool-related (see 
Table 6-2 on p. 6-10 of the StmWindows Reference Manual for a list); 
these will be filtered out by ”tooljparse_aU" and will affect the 
tool. The other options will be seen in the message subwindow (a 
serious tool would parse them). 
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To compile: 


Sample command line: 

parse_all -xxx -yyy -width 100 -zzz -heic 


cc parse_all.c -o parse_all -Isuntool -Isunwindow -Ipixrect 


Copyright (C) 1985 Sun Microsystems Inc. 


#include <stdio.h> #include <suntool/tool_hs.h> #include <suntool/msgsw.h> 

struct tool *tool; /* The tool */ 

struct toolsw *subwin; /* The subwindow */ 

struct pixfont *font; 
int sigwinchcatcher(); 


main(argc, argv) 
int argc; 
char *argv[]; 

{ 



char **tool_attributes = NULL; 
char *tool_name = argv[0]; 
char msg_string[80]; 
argv++; 


argc-; 

if(tooljparse_all(&argc, argv, &tool_attributes, tool_name) ==-!){ 
tool_usage(tool_name); 
exit(l); 


} 

nisg_string[0] = 0; 

while (argc > 0 && **argv ==’-’){ 
strcat(msg_string, *argv); 
strcat(msg_string,""); 
argv++; 
argc-; 



/* Create the tool. */ 

tool = tool_make(WIN_LABEL, aigv[0], 

WIN_ATTR_LIST, tool_attributes, 

0 ); 

if (tool == NULL) { 

^utsC'Can’t make the tool.O, stderr); 
exit(l); 

} 

tool_free_attribute_list(tool_attributes); 
font = pw_pfsysopen(); 
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subwin = msgsw_createtoolsubwmdow(tool,"", 

TOOL_SWEXTENDTOEDGE, TOOL_SWEXTENDTOEDGE, 
msg_string, font); 
if (subwin ==NULL){ 

fputsC'Can’t make the subwindow.O, stderr); 
exit(l); 

} 

/* Install the tool */ 
signal(SIGWINCH, sigwinchcatcher); 
tool_instalI(tool); 

/* Main loop. */ 
tool_select(tool,0); 

/* Clean up */ 
tool_destn)y (tool); 
exit(O);} 


o 


/* Standard SIGWINCH handler. */ sigwinchcatcher() { 
tool_sigwinch(tiOol); } 


#ifhdef lint static char sccidl] = "@(#)findroot.c 2.0 85/05/20 Copyr 1985 Sun Micro"; #endif 

This program illustrates how to find out what a tool’s 
root window’s file descriptor is. This is necessary, for example, 
if you want to use certain of the Window Manager calls which ate 
documented in section 8.5.1 of the 1.1 SunWindows Reference Manual 
(section 9.6.1 of the 2.0 Manual). 

This program creates a tool with a single message subwindow. 
When the user clicks the right-hand mouse button, the wmgr jclose 
call is used to shut the tool down to iconic form. 

The interesting part is the function get_my_iDot_fd(). See 
comments there for details. 
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#include <stdio.h> 

#include <sy3/file.h> 
tinclude <suntool/wmgr.h> 
#include <suntool/tool_hs.h> 
#include <suntool/rasgsw.h> 

struct tool *tool; 
struct toolsw *subwin; 
struct pixfont *font; 
struct inputmask inputmask; 
int subwin selectedO; 


/* The tool. */ 

/* The single subwindow. */ 

/* Font for writing in the subwin. */ 
/* Input mask for the subwindow. */ 

/* "Selected" routine for subwin. */ 


/* Routine to handle SIGWINCH. Nothing special. */ 
sigwinchcatcher() 

{ 

tool_sigwinch(tool); 

} 


main () 

font = pw_j5fsysopen {) ; 

/* Create the tool. */ 

tool = tool_create<"FINDROOT", 

TOOL_NAMESTRIPE | TOOIj_BOUlsrDARYMGR, 

NULL, NULL); 
if (tool == NULL) { 

printf("Couldn't create the tool.O); 
exit(1); 

}; 


/* Create and init the subwindow. */ 
subwin = msgsw_createtoolsubwindow(tool, 

TOOL_SWEXTENDTOEDGE, TOOL_SWEXTENDTOEDGE, 
"Click Right Button to go iconic.", font); 
if (subwin == NULL) { 

printf("Couldn't create the subwindow.0); 
exit(1)/ 

}; 

/* Set up inputmask to accept only RB clicks. */ 
input_imnull(&inputmask); 

win_setinputcodebit(&inputmask,MS_RIGHT); 
win_setinputmask(subwin->ts_windowfd, &inputmask, 
NULL,WIN_NULLLINK); 

subwin->t3_io.tio_selected = subwin_selected; 

/* Install the tool. */ 

signal(SIGWINCH, sigwinchcatcher); 
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tool_install(tool); 

/* Main loop. */ 
tool_select(tool,0); 

/* Cleanup. */ 
tool_de3troy(tool); 
exit (0); 



If we get here, the user must have clicked the right-hand 
mouse button. This routine calls get_my_root_fd() to figure out 
the file descriptor of its root window, then calls wmgr_close() 
to close the tool to icon form. 


/ 

subwin_selected() 

{ 

struct inputevent ie; 
char c[WIN_NAMESIZE]; 
int rootfd; 


} 


input_readevent(subwln->ts_windowfd, &ie); 
rootfd = get_iny_root_fd(tool->tl_windowfd); 
if (rootfd == -1) { 

printf("get_my_root_fd() failed.0); 
exit (3); 

} 

wmgr_close(tool->tl_windowfd, rootfd); 



This is the interesting part of the program. This function 
takes as its argument the file descriptor for a window, and returns 
the file descriptor of the argument’s root window (or -1 if something 
goes wrong). See section 4.4 of the SunWindows Reference Manu^ for 
details on the window hierarchy. 

The strategy is to recursively call win^etlink, working our way 
up the window tree, until we get to the top (i.e. win_getlink returns 
WIN_NULLLINK). The only problem is that win_getlink returns a window 
number, not a file descriptor. To convert the window number to a file 
descriptor, we first call win_numbertoname, which converts the window 
number to a string such as "/dev/win3". Then we open the device in 
order to get a file descriptor. 
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SunWindows Examples 


findrootc 



get_my_root_fd(fd) 
int fd; 

{ 

int original_fd, parentfd; 
char c[WIN_NAMESIZE]; 

original_fd = fd; 

while ( (parentfd = win_getlink(fd,WL_PARENT)) != WIN_NULLLINK ) { 

if (fd != original_fd) 
close(fd); 

win_numbertonaine (parentfd,c); 
fd = open(c,O_RDONLY,0>; 
if (fd == -1) 

return(-1); 

} 

return(fd); 

} 
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This is a list of the differences between files in Release 2.2 and 2.0. 

/bin/as 

/bin/test 

/dev/MAKEDEV 

/etc/gplcg’2.1024 .ucode 

/etc/gplcg2.1152.ucode 

/etc/gpconfig 

/etc/inetd 

/etc/roount 

/etc/nfsd 

/etc/showmount 

/etc/shutdown 

/etc/uroount 

/etc/yp/makedbm 

/etc/ypbind 

/etc/ypserv 

/lib/ccoin 

/lib/fl 

/lib/libc.a 

/usr/bin/adjacentscreens 

/usr/bin/clear_colormap 

/usr/bin/clocktool 

/usr/bin/coretool 

/usr/bin/dbxtool 

/usr/bin/fonttool 

/usr/bin/gfxtool 

/usr/bin/icontool 

/usr/bin/lockscreen 

/usr/bin/perfmeter 

/usr/bin/perfmon 

/usr/bin/screendump 

/usr /bin/screenload 

/usr/bin/shelltool 

/usr/bin/suntools 

/usr/bin/tektool 

/usr/bin/toolplaces 

/usr/diag/sysdiag 

/usr/etc/in.tftpd 

/usr/etc/nfsstat 
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/usr/etc/ping 

/usr/etc/rpc.mountd 

/usr/etc/rpc.yppasswdd 

/usr/etc/trpt 

/usr/include/cgicbind.h 

/usr/include/cgiconstants.h 

/usr/include/cgidefs.h 

/usr/include/cgipw.h 

/usr/include/gpl_pwpr.h 

/usr/include/netinet/ip.h 

/usr/include/nfs/nfs.h 

/usr/include/nfs/nfs_clnt.h 

/usr/include/pascal/devincpas.h 

/usr/include/pixrect 

/usr/include/sun/fbio.h 

/usr/include/sun/gpio.h 

/usr/include/suntool 

/usr/include/usercore.h 

/usr/lib/font/ftS 

/usr/lib/font/fttS 

/usr/lib/f77passl 

/usr/lib/libF77.a 

/usr/lib/libF77_p,a 

/usr/lib/libl77.a 

/usr/lib/libI77_p.a 

/usr/lib/libc_p.a 

/usr/lib/libcgi•a 

/usr/lib/libcgi77.a 

/usr/lib/libcore.a 

/usr/lib/libcoresky,a 

/usr/lib/libdbm.a 

/usr/lib/libpfc.a 

/usr/lib/libpfc_p.a 

/usr/lib/libpixrect.a 

/usr/lib/libsuntool.a 

/usr/lib/libsunwindow.a 

/usr/lib/lint/lint1 

/usr/lib/lint/llib-lc.In 

/usr/lib/lint/llib-lcore.In 

/usr/lib/lint/llib-lcurses.In 

/usr/lib/lint/llib-lm.ln 

/usr/lib/lint/llib-lmp.ln 

/usr/lib/lint/llib-lpixrect.In 

/usr/lib/lint/llib-lsuntool.In 

/usr/lib/lint/llib-lsunwindow.ln 

/usr/lib/lpd 

/usr/lib/sendmail 

/usr/lib/sendmail.main.cf 

/usr/lib/sendmail.subsidiary.cf 

/usr/lib/vwidth 

/usr/src/sun/suntool/get_view_surface.c 

/usr/sys/OBJ/bwl_rop.o 

/usr/sys/0BJ/cg2_colormap.o 


o 
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/usr/sys/0BJ/cg2_rop.o 
/usr/sys/OBJ/cgtwo.h 
/usr/sys/OBJ/cgtwo.o 
/usr/sys/OBJ/conf.o 
/usr/sys/OBJ/consfb.o 
/usr/sys/OBJ/gpl_colonnap.o 
/usr/sys/OBJ/gpl_kern_sync.o 
/usr/sys/OBJ/gpl_rop.o 
/usr/sys/OBJ/gpone-h 
/usr/sys/OBJ/gpone.o 
/usr/sys/OBJ/if.o 
/usr/sys/OBJ/if_ec.o 
/usr/sys/OBJ/if_ether.o 
/usr/sys/OBJ/if_ie.o 
/usr/sys/OBJ/if__loop. o 
/usr/sys/OBJ/ioconf.o 
/usr/sy3/OBJ/ip_icmp.o 
/usr/sys/OBJ/ip_input.o 
/usr/sys/OBJ/ip_output.o 
/usr/sys/OBJ/kbd.o 
/usr/sys/OBJ/keytables-o 
/usr/sys/OBJ/kudp_faStsend.o 
/usr/sys/OBJ/machdep•o 
/usr/sys/OBJ/mem_rop.o 
/usr/sys/OBJ/mti.o 
/usr/sys/OBJ/nfs_server.o 
/usr/sys/OBJ/nfs_subr.o 
/usr/sys/OBJ/nfs_vfsops.o 
/usr/sys/OBJ/nfs_vnodeops.o 
/usr/sys/OBJ/nfs_xdr.o 
/usr/sys/OBJ/raw_ip.o 
/usr/sys/OBJ/sc.o 
/usr/sys/OBJ/sd.o 
/usr/sys/OBJ/st.o 
/usr/sys/OBJ/sys_generic.o 
/usr/sys/OBJ/tcp_debug.o 
/usr/sys/OBJ/tcp_input.o 
/usr/sys/OBJ/tcp_output-o 
/usr/sys/OBJ/tcp_subr.o 
/usr/sys/OBJ/tcp_tiiner .o 
/usr/sys/OBJ/tcp_u3rreq.o 
/usr/sys/OBJ/tty.o 
/usr/sys/OBJ/udp_usrreq.o 
/usr/sys/OBJ/ufs_alloc•o 
/usr/sys/OBJ/ufs_nd.o 
/usr/sys/OBJ/vers.o 
/us r / sy s/OB J/vin_druin. o 
/usr/sys/OBJ/vin_machdep. o 
/usr/sys /OBJ / vni_pt. o 
/usr/sys/OBJ/vm_text.o 
/usr/sys/OBJ/xy.o 
/usr/sys/conf/GENERIC 
/usr/sys/conf/ND120 
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/us r/sys/conf/README 
/usr/sys/conf/RELEASE 
/usr/sys/conf/SDST160GP 
/usr/sys/conf/devices.sun 
/usr/sys/conf/files 
/usr/sys/conf/files.sun 
/usr/sys/conf/makefile.sun 
/usr/sys/sun/conf.c 
/usr/sys/sun/fbio.h 
/usr/sys/sun/gpio.h 
/usr/sys/sundev/scmb.h 
/usr/sys/sundev/st reg.h 
/usr/ucb/ex 
/usr/ucb/ftp 
/usr/ucb/man 
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